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第 速 迭代 


就 是 能 最 快 地 进行 试 错 ， 从 而 才能 最 快 地 找到 正确 


直 是 我 秉承 的 团队 管 开 


视 技术 的 实用 性 ， 快 速 地 使 用 成 熟 好 月 
的 产品 理念 非常 契合 ， 和 希望 大 家 能 够 从 本 书 中 有 所 得 。 


这 是 一 本 朴实 


日 全 面 的 Java 服务 端 和 
到 的 各 种 技术 及 使 用 场景 ， 并 且 恰 当地 圈定 了 写作 的 深度 和 范围 ， 各 块 内 容 介 


LE 理念 ， 在 产品 和 项 目的 实践 过 程 中 ， 第 速 迭代 的 好 处 


的 道路 。 在 我 的 产品 实践 过 程 中 ， 非 常 重 
的 技术 才能 快速 地 抢占 市 场 。 这 本 书 的 编写 理念 和 我 


一 一 刘 春 河 ” 杰 子 城 创始 人 、CEO 


发 技术 类 图 书 , 书 


履 盖 了 应 用 类 服务 端 


发 所 用 
精炼 又 不 失 


完整 性 ， 技 术 歼 盖 全 面 又 重点 突出 ， 能 帮助 读者 快速 搭建 业务 需要 的 框架 和 组 件 ， 加 速 业 务 


的 开发 和 沙 地 。 


我 从 工作 伊始 就 一 直 


[在 带领 以 Java 作为 服务 端 


一 一 解 来 ”北京 文 云 昌 迅 科 技 有 限 公司 CEO, 


前 美国 西部 数据 存储 事业 部 亚太 区 总 载 
开发 语言 的 技术 团队 ， 曾 系统 地 实践 了 以 


Spring Cloud 作为 微服 务 框架 的 分 布 式 系统 。 此 前 ， 我 一 直 在 感叹 业内 缺乏 一 本 从 实践 角度 总 结 
的 框架 性 教材 。 而 今天 这 本 书 ， 恰 好 从 Java 基础、 第 见 组 件 使 用 、 服 务 构建 、 微 服务 框架 介绍 与 


使 


作者 兼 历经 百 战 的 架构 
架 做 了 淋 注 尽 致 的 曾 述 。 基 了 


有 乃至 CICD 等 角度 , 把 
了 我 的 一 个 心愿 。 强烈 推荐 相关 从 业者 阅读 此 书 , 通过 学 习 本 - 
汲取 经 验 。 此 书 是 一 本 不 可 多 得 的 服务 端 帮 
朱 清 ”创始 人 &&CEO @ 链 博 科技 &VENA NETWORK, 


知识 ， 同 时 可 以 从 作者 这 上 


以 致 用 、 


j 以 促 学 、 学 用 相 长 是 本 


构 师 们 作为 必 读 书籍 细 细 品 鉴 阅 读 。 


个 服务 端 研 发 人 员 会 接触 的 方方面面 都 系统 地 进行 了 讲解 ， 算是 了 
可 以 得 到 许多 Java 服务 端 编程 的 


发 参考 书 。 


SPRING CLOUD 中 国 社区 联合 创始 人 


功力 与 乐于 分 享 的 技术 情怀 于 一 身 ， 在 本 书 中 ; 


IHI 


KDA RRA 


多 年 来 对 技术 的 追求 和 积累 ， 沉 淀 了 非常 宝贵 的 金石 之 言 。 
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学 


3 的 写作 精髓 。 强 烈 推荐 给 从 事 分 布 式 


—ité 


开发 的 程序 员 、 


an 


聚 分 享 平台 事业 部 总 经 理 


Ill 


出 版 说 明 


随 着 信息 科学 与 技术 的 迅速 发 展 ， 人 类 每 时 每 刻 都 会 面 对 层 出 不 穷 的 新 技术 和 新 概念 。 
毫 无 疑问 ， 在 节奏 越 来 越 快 的 工作 和 生活 中 ， 人 们 需要 通过 阅读 和 学 习 大 量 信息 丰富 、 具 备 
实践 指导 意义 的 图 书 来 获取 新 知识 和 新 技能 ， 从 而 不 断 提 高 自身 素质 ， 紧 跟 信息 化 时 代 发 展 
的 步伐 。 

众所周知 ， 在 计算 机 硬件 方面 ， 高 性 价 比 的 解决 方案 和 新 型 技术 的 应 用 一 直 备 受 青 睐 ; 
在 软件 技术 方面 ， 随 着 计算 机 软件 的 规模 和 复杂 性 与 日 俱 增 ， 软 件 技术 不 断 地 受到 挑战 ， 人 
们 一 直 在 为 寻求 更 先进 的 软件 技术 而 奋斗 不 止 。 目 前 ， 计 算 机 和 互联 网 在 社会 生活 中 日 益 普 
及 ， 掌 握 计算 机 网 络 技 术 和 理论 已 成 为 大 众 的 文化 需求 。 由 于 信息 科学 与 技术 在 电工 、 电 子 、 
通信 、 工 业 控 制 、 智 能 建筑 、 工 业 产 品 设计 与 制造 等 专业 领域 中 已 经 得 到 充分 、 广 泛 的 应 用 ， 
所 以 这 些 专业 领域 中 的 研究 人 员 和 工程 技术 人 员 越 来 越 迫切 需要 汲取 自身 领域 信息 化 所 带 来 
的 新 理念 和 新 方法 。 

针对 人 们 了 解 和 掌握 新 知识 、 新 技能 的 热切 期 待 ， 以 及 由 此 促成 的 人 们 对 语言 简洁 、 内 
容 充 实 、 融 合 实践 经 验 的 图 书 迫 切 需要 的 现状 ， 机 械 工 业 出 版 社 适 时 推出 了 “信息 科学 与 技 
KAB”. 这 套 从 书 涉及 计算 机 软件 、 硬件 、 网 络 和 工程 应 用 等 内 容 , 注重 理论 与 实践 的 结合 ， 
内 容 实 用 、 层 次 分 明 、 语 言 流畅 ， 是 信息 科学 与 技术 领域 专业 人 员 不 可 或 缺 的 参考 书 。 

目前 ， 信 息 科 学 与 技术 的 发 展 可 谓 一 日 千里， 机 械 工业 出 版 社 欢迎 从 事 信 息 技术 方面 工 
作 的 科研 人 员 、 工 程 技术 人 员 积 极 参与 我 们 的 工作 ， 为 推进 我 国 的 信息 化 建设 做 出 贡献 。 


机 械 工业 出 版 社 
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不 仅 表现 在 纯 科 和 


世纪 的 时 间 内 ， 遵 循 摩尔 定律 2 的 发 
到 现在 的 各 种 高 级 语言 、 框 架 等 ， 最 后 ， 在 技术 应 月 


BART FTAA AMAIA 


ws 


机 的 飞速 发 展 仍 处 于 人 类 的 控制 之 下 ， 还 没 
经 可 以 战胜 人 类 了 。 不 入 前 计算 机 在 围棋 上 战胜 了 人 类 ， 这 其 实 并 没有 天 
者 认为 在 所 有 条 件 和 规则 已 知 ， 


F HAHH 


机 对 局 已 经 毫 无 还 手 之 力 。 
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算 机 现在 的 发 


展 已 经 如 此 健全 和 强大 ， 对 于 计算 机 从 业者 来 说 可 能 3 
因为 从 业者 要 学 习 大 量 的 计算 机 知识 。 这 也 是 笔者 写作 本 书 想 解 决 的 问题 : 
应 该 如 何 学 习 以 及 如 何 最 快 地 学 习 。 所 以 本 
功能 组 件 体系 以 及 其 他 加 


FL 


BTE 


分 ， 而 此 部 分 会 让 读者 快速 地 理解 、 接 收 3 
全 书 共 分 为 五 篇 ， 
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展 规则 ; 


=] 


KE 


EE 把 这 本 书 当 成 在 Java 服务 端 领域 探索 的 一 张 微缩 地 图 。 


计算 机 自发 明 以 来 至 今 不 到 百年 时 间 ， 但 
的 方面 ， 还 表现 在 技术 的 普及 及 应 


其 发 展 速度 却 是 超 乎 想象 的 。 这 种 快速 的 发 展 
用 方面 。 首 先 ， 计 算 机 硬件 在 长 达 半 个 多 


次 ， 计 算 机 软件 从 最 初 的 纸 带 打 孔 编 


机 如 此 迅猛 的 发 展 速 度 ， 当 然 与 广大 从 业者 的 不 断 努 力 和 探索 是 分 不 


=" 


出现 独 立 的 苗头 ，1 


程 已 经 发 展 


目 上 ， 近 几 年 刚刚 成 熟 的 移动 互联 网 ， 已 经 


开 的 。 目 前 计算 
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不 是 


IXA 


Semin SAG Java 相关 
， 有 目的 就 是 通过 最 精炼 的 篇 
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每 篇 内 容 如 下 : 
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家 一 局 
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第 二 篇 主要 讲解 


以 及 微服 务 框架 Spring Cloud. 


Spring 框架 治 


AS — Ai -人事 


第 三 篇 主要 i 


解 在 服务 ! 
件 的 使 用 方法 和 使 用 场景 。 


第 四 篇 主要 


使 
Poke 


第 五 篇 


后 ， 对 相关 内 容 


解 镜像 技术 的 用 法 ， 使 
用 Jenkins 构建 工程 以 及 服务 部 署 相关 的 


Fia 


ERRIRE RT ERA 


际 工作 中 。 


JAJ 


PN 
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主要 讲解 在 日 常 工 作 中 ， 为 了 提 
本 书 采用 循序 渐进 的 方式 ，; 


当 价 格 不 变 时 ， 集 成 电路 上 可 容纳 的 元 器 件 的 数 


述 Java H 


， 约 每 


j 阳 18 一 24 个 月 便 会 增加 一 倍 ， 性 能 也 将 提升 一 倍 。 


B 


E 务 、 消 息 队 列 、 全 局 搜索 等 功能 组 


镜像 技术 快速 搭建 功能 环境 的 服务 组 件 ， 


是 计算 机 在 某 些 特定 领域 已 
8 么 让 人 吃惊 ， 因 
胜 负 标 准 《〈 棋 类 作为 代表 ) 的 前 担 下 ， 人 类 与 计算 


为 笔 


个 好 消息 ， 
么 多 知识 ， 


的 语言 要 点 、 服 务 框 架 、 


， 讲 述 某 一 技术 领域 最 常用 的 部 


主要 讲解 Java 语言 ， 以 及 工程 构建 、 代 码 管 理 和 基本 的 服务 器 命令 ， 以 这 些 内 容 作 
为 本 书 的 起 点 和 基础 。 
理 、 服 务 框架 Spring MVC 和 Spring Boot、 服 务 架 构 的 演进 


并 且 讲解 


局 工作 质量 和 效率 所 使 用 的 研发 工具 。 
有 务 端 研发 所 涉及 的 几 个 领域 。 希 望 读 者 阅读 本 书 
进行 实践 和 总 结 ， 从 而 在 脑海 中 绘制 出 属于 自己 的 技术 版 图 。 


书 中 包含 大 量 代 码 ， 为 了 避免 分 散 读者 的 注意 力 ， 书 中 省 略 了 部 分 重复 的 和 不 重要 的 代 
码 。 如 果 读 者 想 查 看 完整 的 代码 可 以 下 载 本 书 附 带 的 源 代码 进行 了 解 。 


编写 技术 类 书籍 是 一 件 非常 辛苦 的 事情 ， 与 日 常 研发 不 同 ， 编 写 技术 类 书籍 不 仅 要 会 用 涉 


及 的 技术 ， 还 要 了 解 其 原理 ， 并 且 要 以 读者 能 够 理解 的 方式 讲述 出 来 ， 同 时 还 要 保证 技术 使 用 


的 正确 性 以 及 描述 的 准确 性 。 在 编写 此 书 的 过 程 中 ， 两 位 作者 一 直 秉 承 着 实用 且 


精简 的 原则 ， 


经 过 几 轮 的 代码 复查 和 文档 复查 才 终于 结 稿 。 在 此 特别 感谢 默默 支持 着 我 们 的 家 人 ， 朋 友 ， 感 


谢 曾 经 一 起 工作 奋战 过 的 同事 冯 剑 、 侯 金 砖 、 尹 波 ， 感 谢 机 械 工 业 昌 


版 社 车 忱 编 


支持 过 我 们 的 所 有 人 。 谢 谢 大 家 ! 
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辑 ， 感 谢 曾经 
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第 一 篇 Æ 础 fa 


对 于 一 名 研发 人 员 ， 研 发 语言 是 最 基础 的 。 语 言 是 研发 者 和 计算 机 打交道 的 基本 工具 ， 通 
过 编写 不 同 语言 的 代码 ， 然 后 编译 生成 可 执行 文件 ， 这 样 就 完成 了 编程 的 最 基本 工作 。 一 名 研 
发 人 员 每 天 都 通过 语言 来 实现 业务 逻辑 ， 对 语言 的 了 解 和 精通 可 以 让 工作 更 加 得 心 应 手 。 由 于 
Java 的 兼容 性、 覆盖 度 和 热度 都 是 语言 中 较为 出 色 的 ， 所 以 本 书 采用 Java 语言 作为 全 书 使 用 的 
语言 。 

通过 语言 的 学 习 ， 可 以 操作 依赖 库 进行 功能 逻辑 的 研发 ， 但 是 众多 依赖 库 之 间 的 关系 和 管 
理 也 是 一 个 问题 ， 第 2 章 介 绍 的 Maven 将 使 依赖 工作 变 得 简单 ， 并 且 可 以 让 工程 更 加 方便 地 整 
合 起 来 。 

在 日 常 工作 中 ， 编 码 工 作 通 常 不 是 由 一 个 人 独立 完成 的 ， 大 部 分 情况 下 都 是 一 个 研发 小 组 
同时 编写 同一 工程 内 不 同 模块 的 代码 ， 特 殊 情 况 下 会 出 现 不 同 的 人 编写 同一 段 代码 ， 这 样 就 对 
工程 的 代码 管理 提出 了 挑战 。 每 个 人 编写 同一 工程 内 不 同 的 代码 ， 那 么 代码 如 何 合并 ? 不 同 的 
人 编写 同一 段 代 码 ， 这 种 冲突 如 何 处 理 ? 第 3 章 将 介绍 Svn 和 Git 这 两 种 代码 管理 工具 ， 它 们 可 
以 很 好 地 解决 工作 中 的 代码 管理 问题 。 

Java 服务 通常 运行 在 Linux 环境 下 ， 在 工作 中 使 用 的 功能 环境 和 生产 环境 的 服务 器 都 是 基 
于 Linux 的 ， 所 以 对 Linux 命令 的 了 解 是 Java 研发 人 员 必 备 的 技能 。 第 4 章 将 介绍 Linux 的 常 
用 命令 ， 并 且 启 动 一 个 Java 服务 。 

本 篇 的 内 容 虽 然 看 似 彼 此 之 间 关 系 并 不 紧密 ， 但 确实 是 一 名 研发 人 员 每 天 都 在 接触 的 东 
西 。 和 希望 读者 通过 对 本 篇 的 阅读 ， 能 够 有 所 得 ， 并 且 应 用 在 日 常 工作 中 。 
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1 草 


容 的 提炼 笔记 ， 需 要 时 可 以 随手 翻阅 。 


1.1 Java 环境 搭建 


Java W 


Java 是 一 门面 向 对 象 的 编程 语言 ， 它 选择 性 地 吸取 了 C++ 语 言 的 优点 ， 并 在 其 基础 
E、 可 移植 性 、 安 全 性 等 多 个 方面 均 有 所 突破 。 同 
承 性 和 引用 的 概念 (无 指针 ) 也 使 语言 更 易 理 解 。 本 章 通过 讲解 Java 4 
快速 地 了 解 和 使 用 Java。 如 果 您 已 经 对 Java 有 非常 深 的 ] 


Java 的 IDE 工 


始 学 习 Java， 


译 运 行 。 可 以 选择 用 记事 本 编写 代码 、| 


往往 需要 配置 


Java 的 基础 环境 ， 环 境 配置 好 后 ， 就 可 以 编写 Java 代码 并 编 
荐 直接 采用 Eclipse9 作 为 


(编译 并 运行 代码 。 


1.1.1 Java 基础 环境 搭建 


Java 其 而 
础 环境 搭建 的 详细 


J JDK 编译 运行 ， 但 


是 本 书 


EFA 
时 Java 的 单一 继 


FP 常 用 的 能 力 使 读者 能 够 
理解 ， 那 么 此 章 也 可 以 作为 Java 核心 内 


上 环境 搭建 简单 来 说 就 是 下 载 对 应 的 JDK， 安 装 后 配置 对 应 的 环境 变量 。 下 面 是 基 
流程 。 


D) 首先 通过 官网 下 载 对 应 的 JDK 版 本 ， 官 网 地 址 为 http:/www.oracle.com/technetwork/ 


java/javase/downloads/index.html， 本 书 采 
对 应 的 操作 系统 。 


2) 下 载 完 


KI 


fant 


成 后 进行 “傻瓜 式 ” 安 装 ， 安 装 完成 后 进行 环境 变量 的 配 ! 


境 变量 设置 的 地 方 ， 添 加 对 应 的 变量 名 和 值 ， 见 表 1-1。 


表 1-1 Java 环境 变量 配置 


.0 


统一 的 IDK 版 本 1.8。 下 载 时 注意 选择 IDK 的 版 本 和 


在 计算 机 中 找到 环 


变 量 值 
JAVA HOME C:\Program Files\Java\jdk1.8.0_144 
CLASSPATH s%IAVA_HOME%\lib\dt.jar;%oJAVA_HOME%\lib\tools jar; 
Path %JAVA_HOME%\bin;%JAVA_HOME%)\jre\bin; 


3) IDK 基础 环境 安装 完毕 ， 


version， 若 输出 结果 类 似 图 1-1， 则 说 明 
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© Eclipse 不 仅仅 具备 IDE 能 力 ， 但 是 对 于 新 手 来 说 可 以 简单 地 把 它 理 解 为 IDE。 


下 面 通过 命令 行 检测 是 否 正确 安装 。 


基础 环境 搭建 正确 。 


FE 命令 行 输 入 java- 
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1.1.2 Eclipse 的 安装 


IDE (提供 程序 开发 环境 ) 是 每 个 从 事 编 程 工作 的 人 必须 接触 的 工具 ， 一 个 好 的 IDE 能 够 
大 大 地 提高 研发 效率 ，Eclipse 就 是 这 样 一 款 开源 的 工具 。 本 节 介 绍 Eclipse 工具 的 安装 ， 安 装 完 
成 后 使 用 Eclipse 编写 简单 的 代码 ， 通 过 控制 台 输 出 这 段 代码 的 运行 结果 “Hello World!”。 

Eclipse 的 安装 非常 简单 ， 通 过 如 下 几 步 即 可 完成 : 

1) 通过 搜索 找到 下 载 地 址 ， 或 者 直接 去 Eclipse 的 官网 https://www.eclipse.org/downloads/ 进 
行 下 载 。 下 载 时 选择 eclipse-packages， 然 后 选择 Eclipse IDE for Java EE Developers 的 正确 系统 


ay, 
2) 下 载 后 的 文件 为 eclipse-jee-oxygen-2-win32-x86 64.zip， 解 压 此 文件 到 你 想 安 装 的 目录 
下 ， 在 解压 后 的 文件 中 找到 eclipse.exe 可 执行 文件 并 运行 。 

3) 运行 后 程序 会 让 你 选择 工作 空间 ， 设 定好 工作 空间 文件 夹 后 即 可 进入 程序 。 


1.1.3 第 一 个 Java 程序 


Java 基础 环境 和 编译 运行 环境 已 经 准备 妥当 ， 下 面 运行 第 一 个 程序 “Hello World!”。 

1) 在 Eclipse 的 菜单 中 选择 “File->New->Project->Java Project”. Project name 设置 为 
HelloWorld， 可 以 设置 工程 存放 路 径 或 者 默认 ， 然 后 单 击 finish 按钮 。 

2) 此 时 会 生成 一 个 HelloWorld 的 工程 ， 鼠 标 右 键 单 击 此 工程 ， 在 快捷 菜单 中 选择 
“New->Class”, 添加 Name 为 HelloWorld， 可 以 设置 Package 为 自 定义 名 字 〔 一 般 为 域名 的 反 
转 ) 或 者 直接 使 用 默认 名 称 ， 然 后 单 击 finish 按钮 。 

3) 现在 已 经 创建 了 第 一 个 Java 的 类 HelloWorld。 在 此 类 中 填写 如 下 内 容 : 

public class HelloWorld { 


public static void main(String[] args) { 
System.out.println(""Hello World!"); 


I 


} 
} 

4) 在 此 文件 上 用 鼠标 右键 单 击 ， 选 择 “Run AS->Java Application”， 可 在 Console 窗 格 中 看 
到 输出 为 “Hello World! ”。 

以 上 是 一 个 最 简单 的 Java 程序 。 如 果 在 编写 代码 时 经 常 犯 拼写 错误 ， 可 以 设置 Eclipse 代码 
提示 来 解决 这 个 问题 。 把 “Window->Preferences->Java->Editor->Content Assist” 中 的 Auto 
activation triggers for Java 设置 改 为 abcdefghijklmnopqrstuvwxyz. 即 可 。 这 也 是 直接 使 用 IDE 的 好 
ih. 


12 基本 类 型 与 运算 

Java 是 一 种 面向 对 象 的 编程 语言 ， 并 且 Java 的 单 根 继承 结构 导致 所 有 的 对 象 都 是 由 Object 
派生 而 来 ， 但 Java 中 也 存在 一 些 特例 ， 即 Java 的 基本 类 型 。 
1.2.1 基本 类 型 概述 


Java 的 基本 类 型 包含 表示 真 假 的 boolean， 表 示 字 符 的 char， 表 示 数 值 的 byte. short. int, 
long、float、double， 表 示 空 的 void。Java 基本 类 型 的 取 值 范围 及 默认 值 见 表 1-2。 
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表 1-2 Java 基本 类 型 


基本 类 型 大 小 最 小 值 最 大 值 包装 器 类 型 默认 值 
boolean = = z Boolean false 
char 16-bit Unicode 0 Unicode 216-1 Character “\u0000’ (null) 
byte 8-bit -128 +127 Byte byte(0) 
short 16-bit -2" +2"-1 Short short(0) 
int 32-bit -231 +2°'-1 Integer 0 
long 64-bit z383 +2°-1 Long OL 
float 32-bit TEEE754 TEEE754 FLoat 0.0f 
double 64-bit TEEE754 TEEE754 Double 0.0d 
void G Void Š 


下 面 针对 各 个 类 型 ， 通 过 程序 验证 其 具体 情况 。 创 建 一 个 JavaBasicTypes 类 ， 编 号 如 下 代码 : 


public class JavaBasicTypes { 
static char charval; 
static byte byteval; 
static short shortval; 
static int intval; 
static long longval; 
static float floatval; 
static double doubleval; 


public static void basicTypesRange() { 
//char 便于 展示 范围 ， 所 以 做 了 类 型 转换 
System.out.println("char size = " + Character.SIZE); 
System.out.println("char min =" + (int)Character. MIN VALUE); 
System.out.printIn("char max =" + (int)Character. MAX VALUE); 
System.out.println("char default = " + (int)charval); 
/byte 
System.out.println("byte size = " + Byte.SIZE); 
System.out.println("byte min =" + Byte MIN VALUE); 
System.out.println("byte max =" + Byte. MAX VALUE); 
System.out.println("byte default = " + byteval); 
//short 
System.out.printIn("short size = " + Short.SIZE); 
System.out.printin("short min = " + Short. MIN_VALUE); 
System.out.printin("short max = " + Short MAX VALUE); 
System.out.println("short default = " + shortval); 
/int 
System.out.println("int size = " + Integer. SIZE); 
System.out.println("int min = " + Integer MIN VALUE); 
System.out.printIn("int max =" + Integer MAX VALUE); 
System.out.printin("int default = " + intval); 
/long 
System.out.println("long size = " + Long.SIZE); 
System.out.printin("long min = " + Long.MIN VALUE); 
System.out.printin("long max =" + Long. MAX VALUE); 
System.out.println("long default = " + longval); 
//float 
System.out.printin("float size = " + Float.SIZE); 


序 


System.out.printin("float min = " + Float.MIN VALUE); 
System.out.println("float max = "+ Float MAX VALUE); 
System.out.println("float default = " + floatval); 


//double 


System.out.printIn("double size = "+ Double.SIZE); 
System.out.println("double min = "+ Double.MIN VALUE); 


System.out.printIn("double max = 


"+ Double. MAX VALUE); 


System.out.printIn("double default = " + doubleval); 


} 


public static void main(String|] args) { 


basicTypesRange();~ 


} 

} 

运行 结果 如 下 : 
char size = 16 
char min = 0 
char max = 65535 
char default = 0 
byte size = 8 
byte min = -128 
byte max = 127 
byte default = 0 
short size = 16 
short min = -32768 
short max = 32767 
short default = 0 
int size = 32 


int min = -2147483648 
int max = 2147483647 


int default = 0 
long size = 64 


long min = —9223372036854775808 
long max = 9223372036854775807 


long default = 0 
float size = 32 
float min = 1.4E-45 


float max = 3.4028235E38 


float default = 0.0 
double size = 64 


double min = 4.9E-324 


double max = 1.797693 1348623 157E308 


double default = 0.0 


以 上 代码 使 用 它们 的 包装 类 取出 对 应 的 值 ， 此 方法 是 获取 基本 类 型 边界 值 的 最 快 方法 。 程 
的 输出 结果 和 预期 的 一 样 ，7 个 基本 类 


使 用 了 静态 类 和 静态 成 员 


作 


应 尽量 保证 所 有 值 都 


© 静态 方法 basicTypesRange 可 


它们 的 范 
变量 里 ， H 体 讲 解 在 后 面 
己 经 被 正确 初始 化 。 


i 
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用 值 和 默认 值 。 这 段 代码 提前 


以 直接 被 main 方法 调用 


有 具体 原理 后 面 会 有 讲述 ， 本 章 如 非 必要 不 
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会 有 涉及 。 另 外 本 例 仅 用 于 演示 ， 有 具体 工 


展示 main 方法 的 代码 。 
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1.2.2 ”操作 符 


1.2.1 节 介 绍 了 Java 基本 类 型 的 概念 ， 那 么 基本 类 型 如 何 使 用 呢 ? 基本 类 型 的 使 用 与 操作 符 
(运算 符 〉 是 分 不 开 的 。 操 作 符 用 于 进行 变量 或 者 对 象 之 间 的 计算 或 者 关系 判断 ， 没 有 操作 符 就 
无 法 做 任何 运算 、 比 较 或 者 赋值 。 操 作 符 主 要 分 为 以 下 几 类 ， 分 别 是 算术 操作 符 、 赋 值 操作 
符 、 关 系 操作 符 、 邮 辑 操作 符 、 位 操作 符 和 其 他 操作 符 。 


CL) 算术 操作 符 : 包括 加 号 〈+)、 减 号 (-)、 乘 号 (*)、 除 号 〈/) 以 及 
除法 的 余数 )、 自 增 和 自 减 运算 符 (++ 和 一 )。 二 元 ” 算 


写 的 目的 ， 例 如 a+=bS 表 示 a=atb。 代 码 如 下 : 
public static void testArithmeticOperator() { 


int i= 123; 

intj=5; 

System.out.printIn("i +j =" + (+j); 
System.out.println("i -j = "+ (-)); 
System.out.println("i * j =" + (*})); 


System.out.println("1 / j =" + G5); 
System.out.printin("i % j =" + (i%j)); 


System.out.println("i++ =" + (i++); 
System.out.println("i =" + i); 
System.out.println("++i =" + (+4+1)); 
System.out.println("i = " + i); 
System.out.printIn("i-—— = " + (i—)); 
System.out.println("i = " + i); 
System.out.println("—1 = "+ (~-i)); 
System.out.println("i =" + i); 


int sum =i +j; 
System.out.printin("sum = " + sum); 
i+=j; 

System.out.println("i += j =" + i); 


i++ = 123 
1= 124 
+H = 125 
i= 125 
i-- = 125 
1= 124 
— = 123 
1= 123 
sum = 128 


O 算式 中 出 现 的 数据 个 数 ， 二 元 表示 操作 符 处 理 两 个 操作 数 


的 关系 。 


芭 模 操作 符 〈%， 


术 操 作 符 与 等 号 连接 使 用 可 以 达到 简化 书 


增 和 


O 此 种 方法 虽然 书写 简单 ， 但 是 新 手 没 搞 清 楚 之 前 不 建议 使 用 。 
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i+=j=128 


输出 结果 可 见 ， 运 月 
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算术 操作 符 ， 可 以 进行 对 应 的 数学 运算 。 请 注意 除法 对 于 int 类 型 来 


讲 是 直接 去 掉 小 数 点 后 面 数字 的 ， 而 不 是 四 舍 五 入 ; 自 增 自 减 操作 符 写 在 不 同 的 位 置 得 到 的 结 


果 是 不 同 的 ， 简 化 的 运算 
(2) 赋值 操作 符 ; a de 用 的 符 写 “=” 它 的 目的 就 是 把 右边 的 值 赋 
值 给 左边 。 


作 符 的 一 种 简化 合 3 
(3) 关系 操作 符 : E 


有 些 书 把 “=” 操 作 符 也 归 入 赋值 操作 符 ， 但 是 作者 认为 这 仅仅 是 算术 操作 符 与 赋值 操 
写法 ， 列 入 算术 操作 符 或 赋值 操作 符 均 可 ， 这 里 就 不 再 过 多 介绍 
要 包含 6 种 操作 符 ， 上 基体 含义 见 表 1-3。 


符 赋 值 写法 会 改变 左 侧 变量 的 值 。 


a 


o 


R13 关系 操作 符 

操 作 符 描述 

一 俭 查 左右 两 侧 操作 数 是 否 相 等 ， 相 等 为 真 

= 检查 左右 两 侧 操 作 数 是 否 不 等 ， 不 等 为 真 

> 仿 查 左 侧 操作 数 是 否 大 于 右 侧 操作 数 ， 大 于 为 真 

< 检查 左 侧 操作 数 是 否 小 于 右 侧 操作 数 ， 小 于 为 真 

>= AE AE UE ERE RA FS UE, PRE BS 

< 检查 左 侧 操作 数 是 否 小 于 或 等 于 右 侧 操作 数 ， 小 于 或 等 于 为 真 
下 面 通过 代码 演示 关系 操作 符 的 使 用 方法 及 判断 结果 。 


public static void testRelationalOperator() { 


int value = 10; 


System.out.println("value = 10 is "+ (value = 10)); 
System.out.printIn("value != 10 is "+ (value != 10)); 
System.out.println("value != 11 is "+ (value != 11)); 
System.out.printIn("value > 9 is " + (value > 9)); 
System.out.printIn("value < 9 is " + (value < 9)); 
System.out.printIn("value >= 10 is " + (value >= 10)); 
System.out.println("value <= 8 is " + (value <= 8)); 


} 
运行 结果 如 下 : 


value = 10 is true 
value != 10 is false 
value != 11 is true 
value > 9 is true 
value < 9 is false 
value >= 10 is true 
value <= 8 is false 


可 以 把 关系 操作 符 用 于 变量 之 间 的 比较 ， 本 例 为 了 直观 直接 使 用 数值 进行 比较 。 
(4) BERET: 包含 逻辑 与 操作 符 “&&”， 迪 辑 或 操作 符 “||”， 风 辑 非 操作 符 “!”。 风 
辑 与 操作 符 当 两 侧 都 为 真 时 为 真 ， 风 辑 或 操作 符 当 两 侧 有 一 个 为 真 时 为 真 ， 风 辑 非 操作 符 表示 


取 反 。 


下 面 押 示人 代码 演示 了 好 和 辑 操作 符 的 使 用 方法 。 迪 辑 或 操作 符 稍 有 特殊 : 当 第 一 个 表达 式 为 
不 再 执行 第 二 个 表达 


public static void testLogicalOperator() { 


真 时 ， 


大 式 ， 这 种 情况 称 为 短路 。 
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System.out.println("logical true && true is " + (true && true)); 
System.out.println("logical true && false is " + (true && false)); 
System.out.println("logical true || true is " + (true || true)); 
System.out.printin("logical true || false is " + (true || false)); 
System.out.println("logical false || false is " + (false || false)); 
System.out.printin("logical !true is " + (!true)); 
System.out.println("logical !false is " + (!false)); 


int i= 10, j = 20; 
System.out.println("logical || short circuit is " + ((i++) > 5 || (G++) > 2))); 
System.out.printin("i ="+1+"j="+]); 


j 
运行 结果 如 下 
logical true && true is true 


logical true && false is false 
logical true || true is true 

logical true || false is true 

logical false || false is false 

logical !true is false 

logical ! false is true 

logical || short circuit is true 
i=11j=20//j 没有 进行 自 增 运 算 


(5) 位 操作 符 : 用 来 操作 整数 基本 数据 类 型 中 的 二 进 制 位 。 这 种 用 法 在 实际 使 用 中 比较 少 
用 。 下 面 以 整数 类 型 int 为 例 ， 讲 解 位 操作 符 的 用 法 。 代 码 如 下 : 
public static void testBitwiseOperator() { 
int i= 15; 
int j= 11; 
System.out.println("i binary is " + Integer.toBinaryString(i)); 
System.out.println("j binary is " + Integer.toBinaryString(j)); 
System.out.printiIn("i & j=" + (i & jJ) +",Binary =" + Integer.toBinaryString(i & j)); 
System.out.printin("i |j =" + (i |J) + ",Binary =" + Integer.toBinaryString(i | j)); 
System.out.printin("i ^j =" + (i ^j) + ",Binary =" + Integer.toBinaryString(i ^ 4); 
System.out.printIn("~i =" + (~i) + ",Binary = " + Integer.toBinaryString(~1)); 
System.out.printIn("i << 2 =" + (i << 2) +",Binary =" + Integer.toBinaryString(i << 2)); 
System.out.printIn("i >> 2 =" + (i >> 2) +",Binary =" + Integer.toBinaryString(i >> 2)); 
intk=-1; 
System.out.printIn("—1 Bianry = " + Integer.toBinaryString(k)); 
System.out.printIn("k << 2 =" + (k << 2) +",Binary =" + Integer.toBinaryString(k << 2)); 
System.out.printIn("k >> 2 =" + (k >> 2) +",Binary =" + Integer.toBinaryString(k >> 2)); 
System.out.printIn("k >>> 2 =" + (k >>> 2)+",Binary =" + Integer.toBinaryString(k >>> 2)); 


} 
运行 结果 如 下 : 
i binary is 1111 
j binary is 1011 
i & j=11,Binary = 1011 
i|j = 15,Binary = 1111 
i ^j =4,Binary = 100 
~i=—16,Binary = 11111111111111111111111111110000 
i<<2=60,Binary = 111100 


i>>2=3,Binary = 11 


-1 Bianry = 11111111111111111111111111111111 
k<<2=~—4,Binary = 11111111111111111111111111111100 
k>>2=~—1,Binary = 11111111111111111111111111111111 


k >>> 2 = 1073741823, Binary = 111111111111111111111111111111 


上 面 例子 中 使 用 的 ntegertoBinaryString(0) 方 法 ， 是 转化 整 型 
二 进 制 的 展示 形式 ， 然 后 


打印 了 两 个 整数 的 
符 的 含义 见 表 1-4。 
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! 数 为 二 进 制 数 的 展示 


KR。 代 码 中 先 
通过 位 操作 符 对 数字 进行 操作 ， 获 取 结 果 。 位 损人 
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表 1-4 位 操作 符 
位 操作 符 作 
& 左右 两 个 操作 数 按 位 进行 与 操作 ， 即 都 为 1 才 为 1 
| 左右 两 个 操作 数 按 位 进行 或 操作 ， 即 有 一 个 为 1 则 为 
人 左右 两 个 操作 数 按 位 进行 异 或 操作 ， 不 同 则 为 1 
~ 对 操作 数 按 位 取 反 
<< 按 位 向 左 移动 
>> 按 位 向 右 移动 〈 左 侧 用 符号 位 的 数字 补 齐 ) 
>>> 不 带 符 号 的 向 右 移动 


表 中 难以 理解 的 地 方 就 是 负数 


即 可 。 
(6) 三 元 操作 符 : 此 操作 符 较 为 特殊 ， 因 
一 个 操作 数 的 判断 条 件 是 否 为 真 ， 在 后 面 两 个 操作 数 中 选择 一 个 。 


Condition? value0: valuel; 


如 果 Condition 为 真 ， 选 择 valued, 


public static void testConditionOperator() { 


System.out.printIn("condition operator trueCondition = " + 
(true?"conditionTrue":"conditionFalse")); 
System.out.println("condition operator falseCondition = " + 
(false?"conditionTrue":"conditionFalse")); 


} 
运行 结果 如 下 : 


否则 选择 valuel。 


condition operator trueCondition = conditionTrue 
condition operator falseCondition = conditionFalse 


D 字符 串 操作 符 


符 : 前 面 的 例子 中 已 经 大 量 使 用 此 操作 符 ， 字 


或 者 “+ ”实现 ， 


IBA 


型 和 


RAIT 


public static void testStringOperator() { 
String stringValue = "string value "; 


inti=1j 


= 


System.out.println(stringValue + 


System.out.println(stringValue + 


Fi+j); 


System.out.println(i + j + stringValue); 
stringValue += "add other string "; 
System.out.println(stringValue); 


G +j); 


代码 如 下 : 


Po AA 


字符 串 的 连接 通过 


“+” 操 作 时 会 转化 为 字符 串 。 代 码 如 下 : 


a 


操作 


AAA 6 


fe +” 


的 位 操作 ， 但 是 这 种 操作 使 用 较 少 ， 待 使 用 时 再 详细 了 解 


AAA 


HEA 3 个 操作 数 。 简 单 来 讲 ， 此 操作 符 通过 第 
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运行 结果 如 下 : 
string value 12 


string value 3 
3string value 


string value add other string 


可 见 ， 字 符 串 连续 与 整 型 进行 “+” 操 作 时 ，1 
字 ， 而 不 是 进行 了 数字 的 加 法 操作 。 当 用 O 把 数字 括 起 来 后 ， 数 字 才 可 以 正 丰 


及 了 操作 符 的 优先 级 ， 见 表 1-5。 


于 操作 符 的 结合 性 ， 是 自 左 向 右 连接 了 数 
相 加 ， 这 又 涉 


表 1-5 ”操作 符 的 优先 级 和 结合 性 9 

th 先 级 Be E 符 类 型 结 合 性 
1 0 括号 操作 符 ERA 
1 0] 方 括号 操作 符 E 至 右 
2 !、+《〈 正 号 ) 、-〈 负 号 ) 一 元 操作 符 BA 
2 ~ 位 操作 符 BBA 
2 Hy 一 增 自 减 操 作 符 BBA 
3 * 1 % 算术 操作 符 ETA 
4 ty 算术 操作 符 E 至 右 
5 <<, > 位 操作 答 日 左 至 右 
6 > >S, <, <= 关系 操作 符 ERA 
7 =, 上 = 关系 操作 符 rE 
8 & 位 操作 符 cea 
9 人 位 操作 符 E 至 右 
10 | DERIVE 左 至 右 
11 && 逻辑 操作 符 ERA 
12 Il 逻辑 操作 符 E 至 右 
13 条 件 操作 符 HBA 
14 a 赋值 操作 符 HBA 


1.2.3 ”类 型 转换 与 越界 


表示 数值 的 基本 类 型 之 间 是 可 以 进行 相互 转换 


G SPURN 


换 时 可 以 获得 更 高 的 精度 或 者 更 
往 意味 着 丢失 或 者 其 他 问题 。boolean 是 不 能 和 其 他 类 型 进行 转 


问题 。 


大 的 存储 空 


围 比较 小 的 类 型 向 较 大 类 型 


间 ; 当 取 值 范 围 比较 大 下 


的 类 型 向 较 小 的 类 型 转换 时 ， 


换 的 。 下 面 用 几 个 例子 来 说 明 这 


C1) 类 型 转换 ， 以 int 为 初始 数据 类 型 ， 赋 整数 的 最 大 值 ， 然 后 向 其 他 类 型 转换 。 代 码 如 下 : 


public static void testConversion() { 
int i= Integer MAX VALUE; 


System.out.println("max int =" + i); 


short j = (short)i 


s 


System.out.println("max int to short = " + j); 


long k= 1; 


System.out.printIn("max int to long = " + k); 


float x = i; 


System.out.printin("max int to float =" + x); 


double y =i; 


O AATEC 
10 


MELNA, PFO 


还 不 理解 优先 级 的 情况 请 


律 使 


括号 进行 明确 的 操作 区 域 分 隔 。 


转 


往 
JEI 


a 
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System.out.println("max int to double + " + y); 


max int = 2147483647 

max int to short = -1 

max int to long = 2147483647 

max int to float = 2.14748365E9 
max int to double + 2.147483647E9 


可 见 ， 当 int 42) short 的 时 候 ， 存 在 风险 ， 当 int 转 为 long 时 一 切 正常 ， 当 int 转 为 float 时 
数据 会 丢失 一 部 分 ， 当 int 转 为 切 正 常 。 
(2) RA: 观察 儿 种 类 型 已 经 为 可 表示 的 最 大 值 时 ， 再 进行 加 运算 会 发 生 什 么 ; 或 者 儿 种 
类 型 已 经 为 可 表示 的 最 小 值 时 ， 再 进行 减 运算 会 发 生 什 么 。 代 码 如 下 : 
public static void testOutRange() { 
int i= Integer MAX VALUE; 
System.out.println("max int =" + i); 
i=i+ l; 
System.out.println("max int + 1 =" + i); 


int j = Integer.MIN_VALUE; 
System.out.println("min int =" + j); 
j=j- 

System.out.println("min int — 1 =" + j); 


double x = Double.MAX VALUE; 
System.out.println("max double =" + x); 

x =x + Double. MAX VALUE; 
System.out.println("max double + max double = " + x); 


double y = -Double.MAX_ VALUE;® 
System.out.println("- max double = " + y); 

y =y - Double MAX_VALUE; 

System.out.println("- max double - max double = " + y); 


} 
运行 结果 如 下 : 
max int = 2147483647 
max int + 1 = -2147483648 
min int = —2147483648 
min int — 1 = 2147483647 
max double = 1.797693 1348623157E308 
max double + max double = Infinity 
— max double = —1.797693 1348623 157E308 
— max double — max double = -Infinity 


越界 的 运算 往往 出 现 意 想 不 到 的 结果 ， 虽 然 实际 使 用 这 些 类 型 时 ， 只 要 正确 地 分 配 了 对 应 
的 类 型 (例如 不 要 给 手机 号 分 配 byte KA), 一般 都 不 会 出 现 这 种 情况 。 但 是 如 果 代 码 编写 中 出 
现 了 错误 ， 还 是 会 遇 到 越界 的 情况 。 


re 


O 感 兴趣 的 读者 可 以 了 解 一 下 为 什么 使 用 -DoubleMAX VALUE 而 不 使 用 DoubleMIN VALUE。 
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(3) boolean 的 使 用 : boolean 不 可 以 通过 其 他 类 型 转换 而 来 〈 与 C++ 不 同 )，boolean 的 值 只 
能 是 true 或 者 false。 代 人 码 如 下 : 


public static void testBoolean() { 
boolean bool = false; 
inti=1; 
//bool = (boolean)i; 
bool = (i>=1)?true: false; 
System.out.printin("boolean value =" + bool); 


} 
运行 结果 如 下 : 

boolean value = true 
TEES, FORE ERI Ek, ESE. 

(4) 运算 中 的 转换 与 赋值 ， 当 不 同类 型 同时 参与 一 组 运算 时 ， 往 往 伴随 着 类 型 转换 ， 而 类 
型 的 转换 都 是 向 上 (更 大 ) 转换 。 代 人 码 如 下 : 


public static void testOperation() { 
inti= 6,=5; 
int k = i/j; 
System.out.println("int i/j =" + k); 
double x = i/j; 
System.out.println("double i/j =" + x); 
double y = (double)i/j; 
System.out.println("double (double)i/j = " + y); 
double z = i*1.0/j; 
System.out.println("double i*1.0/⁄ =" + z); 


int i/j=1 
double i/j = 1.0 
double (double)1/j = 1.2 
double i*1.0/j = 1.2 
m ` int 相 除 的 结果 赋 给 int 类 型 时 ， 会 去 掉 小 数 点 后 面 的 数 。 
m 当 int 相 除 的 结果 赋 给 double 类 型 时 ， 其 实 是 先 得 出 int 的 整数 值 ， 然 后 用 这 个 得 出 的 整 
数值 赋 给 double 类 型 ， 所 以 还 是 会 丢失 数据 ， 但 是 精度 提高 了 。 
图 当 int 相 除 时 进行 显 式 的 类 型 转换 ， 则 结果 为 double 类 型 。 
图 当 以 int 先 乘 以 一 个 double 类 型 的 值 ， 此 int 值 已 经 升级 为 double 类 型 ， 计 算 结果 赋 给 
double 类 型 可 以 得 到 正确 的 值 。 


1.3 流程 控制 


程序 在 执行 时 会 出 现 各 种 情况 ， 例 如 上 一 节 通 过 关系 操作 符 和 逻辑 操作 符 得 出 的 结果 ， 会 
走 癌 不 同 的 程序 分 文 ， 如 何 实现 分 文 的 选择 就 属于 流程 控制 。 另 外 程序 还 会 出 现 不 停 执 行 某 语 
名 ， 直 到 执行 条 件 不 成 立 为 止 的 情况 ， 这 也 属于 流程 控制 。Java 处 理 流程 控制 的 关键 字 和 语句 
包含 if-else、while、do-while、for、return、break、continue、switch。 本 节 讲 解 以 上 主要 流程 控 
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制 语 句 的 使 用 方法 。 
1.3.1 If-else 


if-else 语句 主要 是 根据 if 语句 的 判断 结果 ， 选 择 不 同 的 分 支 路 径 。 此 语句 有 几 种 不 同 的 写 
法 : 站 后 面 可 以 没有 else 语句 ; if-else 语句 一 起 使 用 ; 或 者 else 后 面 可 以 再 连接 一 个 if 的 判断 
语句 ， 继 续 进行 条 件 判 断 。 代 码 如 下 : 
public static void testIfElse(int num) { 
System.out.printin("num = " + num); 
if(num < 10) { 
System.out.printin("num < 10"); 


} 


if(num < 100) { 
System.out.println("num < 100"); 
yelse { 
System.out.printIn("num >= 100"); 


} 


if(num < 50) { 
System.out.println("num < 50"); 
yelse if(num>=50 && num <100) { 
System.out.println("num>=50 && num<100"); 
yelse { 
System.out.println("num > 100"); 


num = 51 

num < 100 

num>=50 && num <100 
在 上 面 的 例子 中 ， 传 入 的 参数 为 51， 可 见 第 一 个 让 条 件 判断 不 成 功 ， 所 以 对 应 的 代码 段 没 
有 执行 ， 第 二 个 if 语句 判断 成 功 ， 所 以 显示 了 num<100; 最 后 ， 在 else 后 面 的 if 语句 判断 成 
功 ， 所 以 显示 num>=50 && num <100。 


1.3.2 Switch 


当 使 用 if-else 语句 时 ， 如 果 需 要 判断 的 条 件 过 多 ， 那 么 会 出 现 很 多 个 if-else 语句 ， 这 样 的 
代码 可 读 性 是 很 差 的 ， 当 出 现 这 种 情况 时 推荐 使 用 switch 语句 。switch 语句 列 出 了 所 有 待 选 条 
件 ， 当 符合 条 件 判断 时 则 执行 相应 的 代码 。 例 如 : 
public enum® Color { 
RED, GREEN, BLACK, YELLOW 
} 


public static void testSwitch(Color color) { 


switch (color) { 


O 枚 举 类 型 可 以 先 理 解 为 对 几 个 同类 常量 值 的 封装 。 
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case RED: 
System.out.println("color is " + Color.RED); 
break; 
case GREEN: 
System.out.printin("color is " + ColorGREEN); 
break; 
case BLACK: 
System.out.println("color is " + Color.,BLACK); 
break; 
case YELLOW: 
System.out.println("color is " + Color. YELLOW); 
break; 
default: 
break; 
} 
} 
当 传 入 参数 为 ColorRED 时 ， 输 出 为 : 
color is RED 


swtich 语句 的 主要 写法 如 上 所 示 ， 用 case 列举 各 种 情况 进行 匹配 ， 当 匹配 成 功 时 执行 相应 
的 代码 段 ， 代 码 段 的 后 面 用 break 结束 执行 。break 的 主要 作用 就 是 结束 当前 的 选择 语句 或 者 循 
环 语句 。 如 果 去 掉 case 后 面 对 应 的 break 语句 ， 那 么 代码 将 继续 执行 下 一 个 case 的 内 容 。 连 续 
执行 的 特性 在 实际 工作 中 会 有 用 处 ， 但 是 在 没有 彻底 搞 清 楚 之 前 不 建议 使 用 。 


1.3.3 For 
for 循环 其 实 是 依靠 三 个 字段 来 达成 循环 的 目的 ， 三 个 字段 分 别 是 初始 值 、 结 束 条 件 、 游 标 
移动 。 设 置 一 个 游标 的 初始 值 ， 每 次 循环 移动 游标 ， 达 到 结束 条 件 时 结束 循环 。 例 如 : 
public static void testFor() { 
int[] array = new int[10]; 
for(int 1=0;i<10;1++) { 
array[1] = i; 


j 


for(int j:array) { 
System.out.print(j+" "); 


0123456789 
上 例 中 使 用 了 两 种 for 循环 的 用 法 ， 第 一 种 是 基本 的 for 循环 使 用 方法 ， 用 for 循环 实现 了 数组 
的 赋值 。 第 二 种 方法 是 对 已 有 的 数据 进行 遍历 ， 是 for 循环 的 简单 写法 。 


1.3.4 While 
while 也 是 一 种 循环 控制 的 方法 ，while 后 面 跟随 一 个 判断 条 件 ， 当 条 件 成 立时 则 执行 后 面 
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程序 段 的 语句 。do-while 方法 则 是 先 执 行 语句 ， 


public static void testWhile() { 
int[] array = new int[10]; 
int i= 0; 
while(i<array.length) { 
array[i] = i; 
i++; 


} 


于 进行 条 件 判断 。 


intj=0; 

do { 
System.out.print(array[j]+" "); 
ims 

} while (j<array.length); 


0123456789 


55 = 
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例如 : 


for 和 while 都 是 Java 进行 循环 操作 的 方法 ， 但 是 写 循 环 时 一 


谨慎 ， 除 了 有 目的 的 无 穷 


定 要 


循环 2 以 外 一 定 要 确 
for 语句 中 又 仍 套 了 一 层 for 语句 ， 一 定 要 确定 这 种 写法 不 会 对 程 
套 循环 的 时 间 复 杂 度 是 两 个 循环 执行 次 数 相 乘 ， 应 尽量 优化 这 利 


的 容器 来 蔡 代 其 中 的 一 层 循环 等 。 除 非 确实 必要 ”， 尽 量 不 要 写 3 
会 让 程序 完全 失控 。 


1.3.5 break 与 continue 
break 与 continue 在 循环 中 起 着 习 


EE 要 


定 循环 可 以 退出 ， 即 有 结束 条 件 并 且 可 以 结束 。 


HEM. break 可 以 直接 退 H 


AME MANE, Bi Un 
FRI EM TIE ARAM ZN, i 


PRE Si, Bil Ue A Eee dk 


BU EREKE ROME 


AS 


整个 循环 ， 当 循环 撕 


时 ， 退 日 


public static void testBreakAndContinue() { 
int[] array = new int[10]; 
for(int 1=0;1<10;i++) { 
array[i] = i; 


j 
for(int j:array) { 
ifj ==3) { 


continue; 


System.out.printj+" "); 
} 


O 无 穷 循环 ， for(:;) 和 while(true) 这 两 种 写法 。 
除非 任何 方式 都 不 能 实现 目标 逻辑 ， 否 则 都 不 要 写 3 ERD ERE. 


a 


H break 所 属 的 循环 ，continue 可 以 结束 本 次 循环 ， 进 行 下 次 循环 。 例 如 : 
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| 


运 和 
01245 


上 面 的 代码 对 前 面 的 for 循环 的 例子 进行 修改 ， 在 


接 进 行 下 次 循环 ， 所 以 3 没有 打印 


Bet 


打印 时 设置 了 条 件 判断 ， 当 j 为 3 时 ， 直 


来 ， 当 j 为 6 时 ， 直 接 退 出 整个 循环 ， 所 以 6 以 后 的 数字 没 


有 打印 。 


1.3.6 ”Return 


retum 语句 可 以 退出 当前 的 方法 ， 并 且 可 以 带 出 返回 值 ; h 


四 .二 -< 


WARS void 返回 值 的 方法 没有 


的 结尾 有 
finally。 例 如 : 


写 return, WACEAY 
一 个 例外 


ab 


隐 式 的 return. return 语句 后 面 的 代码 段 都 不 会 执行 ， 但 是 有 


public static void testReturn(int num) { 
System.out.println("testReturn start*******"); 


("testReturn try *******"); 


System.out.println("testReturn finally*******"); 


出 分 别 为 : 


if(num = 1) { 
return; 
yelse 1f(num == 2) { 
try { 
System.out.println 
return; 
} finally { 
j 
j 
System.out.println("testReturn end*******"); 
} 
public static void main(String[] args) { 
testReturn(2); 
j 
在 main 方法 中 传 不 同 参数 的 输 
0: 


testReturn start******* 
testReturn end******* 

1: 

testReturn start******* 
2: 

testReturn start******* 
testRetum try *** 
testReturn finally******* 


return 语句 的 执行 就 代表 一 个 方法 的 结束 。return 语句 后 面 可 以 跟随 
值 ， 例 如 return 0; 至 于 finally 这 个 特例 会 在 1.8 Wi, cH 


14 对象 


Java 是 一 利 
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面向 对 象 的 语言 ， 什 么 是 面向 对 象 以 及 如 何 使 用 


个 变量 


用 于 返 


仅 作为 演示 。 
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1.4.1 什么 是 对 象 


什么 是 对 象 ? 试想 身边 常用 的 任何 物品 ， 拿 正在 使 用 的 手机 举例 。 把 手机 比喻 成 对 象 ， 那 
么 手机 的 硬件 例如 CPU、 显 示 屏 、 电 池 就 是 对 和 象 里 的 字段 ， 打 电话 、 使 用 app、 上 网 等 就 是 对 
象 里 的 方法 。 面 向 对 象 的 核心 其 实 就 是 把 任何 事物 抽象 为 类 ， 这 个 事物 具备 的 能 力 就 是 抽象 出 
来 的 方法 ， 这 个 事物 具备 的 各 个 实际 物品 就 是 抽象 出 来 的 字段 。 下 面 以 学 生 为 例 ， 编 写 一 个 学 
生 类 并 创建 它 的 实例 2 。 


public class Student { 
private int age; 
private String name; 


public int getAge() { 
return age; 

} 

public void setAge(int age) { 
this.age = age; 

} 

public String getName() { 
return name; 


} 
public void setName(String name) { 
this.name = name; 
} 
} 
观察 上 面 的 代码 ， 这 个 类 名 叫 Student (Java 的 public 的 类 名 必须 和 文件 名 相同 )。 这 个 类 从 
学 生 这 个 群体 中 抽象 出 来 两 个 字段 ， 一 个 是 age 年 龄 )， 一 个 是 name (名 字 )。 可 以 通过 get 或 
者 set 方法 对 字段 进行 获取 和 设置 操作 ， 例 如 getAge0 方 法 得 到 学 生 的 年 龄 。 下 面 根据 这 个 抽象 
出 来 的 类 ， 创 建 第 一 个 实体 (实例 )。 
public static void main(String[] args) { 
Student student = new Student(); 


j 
通过 new 关键 字 ， 可 以 创建 菜 个 类 的 实例 。 这 样 就 完成 了 Java 面向 对 象 最 基本 的 抽象 和 实 
例 创 建 的 过 程 。 其 中 类 是 抽象 ，new 是 创建 此 类 型 单个 实例 个 体 。 


1.4.2 方法 


前 面 代码 中 已 经 大 量 使 用 了 方法 ， 读 者 对 方法 的 使 用 应 该 也 有 一 个 初步 的 了 解 。 方 法 主要 
包含 4 个 内 容 ， 按 照 顺序 分 别 是 ， 返回 值 、 方 法 名 、 参 数 、 方 法 体 。 也 可 以 用 其 他 关键 字 来 修 
饰 一 个 方法 ， 以 达到 其 他 能 力 ， 例 如 方法 的 可 见 范围 和 静态 ” 。 
普通 方法 的 调用 格式 是 Objectfun(arg)j;。 下 面 编写 代码 对 上 一 节 创 建 的 实例 进行 方法 的 
调用 。 


public static void main(String[] args) { 
Student student = new Student(); 


O 可 以 叫 作 创建 一 个 类 的 实例 ， 或 者 创建 一 个 类 的 对 象 。 
© public 等 关键 字 可 以 修饰 方法 的 可 见 范围 ，static 可 以 设置 方法 为 静态 。 
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student.setAge(12); 

student.setName("xiaoming"); 

System.out.printin("student age = " + student.getA ge()); 
System.out.printIn("student name = " + student.getName());; 


student age = 12 

student name = xiaoming 
在 代码 中 已 经 演示 了 创建 对 象 以 及 方法 的 调用 ， 为 了 揭示 对 象 更 多 的 特性 ， 需 要 再 创建 一 
个 类 School。 具 体 代码 如 下 : 


import java.util.ArrayList; 
import java.util.List; 


public class School { 
private String address; 
private String name; 
List<Student> stList = new ArrayList<Student>(); 


public String getAddress() { 
return address; 

} 

public void setAddress(String address) { 
this.address = address; 


} 

public String getName() { 
return name; 

} 


public void setName(String name) { 
this.name = name; 

} 

public List<Student> getStList() { 
return stList; 

} 

public void setStList(List<Student> stList) { 
this.stList = stList; 


} 


上 面 的 代码 中 用 到 了 import 关键 字 ， 它 的 作用 是 引用 其 他 类 ， 本 例 中 它 引 用 了 List 容器 
类 2。 以 后 在 代码 中 使 用 其 他 的 类 时 ， 也 需要 用 此 关键 字 引 入 。 
代码 中 的 School 类 是 对 学 校 的 抽象 ， 包 含 的 字段 有 地 址 、 名 字 以 及 学 生 列 表 。 可 以 实现 新 
的 方法 ， 用 于 把 学 生 添加 到 学 校 的 学 生 列表 中 。 有 具体 代码 如 下 : 
public void addStudent(int age,String name) { 
Student student = new Student(); 
student.setAge(age); 


student.setName(name); 
addStudent(student); 


i 


i 


© List 类 是 一 种 容器 类 ， 用 于 存放 列表 。 
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} 


public void addStudent(Student student) { 
stList.add(student); 


} 
以 上 两 个 方法 负责 把 学 生 添 加 到 学 生 列表 ， 下 面 使 用 这 两 个 方法 向 学 校 中 添加 学 生 。 

public static void main(String[] args) { 
School school = new School(); 
school.setAddress("beijing"); 
school.setName("ginghua"); 
school.addStudent(18, "xiaoming"); 
Student student = new Student(); 
student.setAge(19); 
student.setName("daming"); 
school.addStudent(student); 
System.out.println(school.getStList().size()); 


j 
通过 上 面 的 代码 可 见 ， 两 个 相同 名 字 的 方法 都 可 以 用 于 把 学 生 放 入 学 生 列表 ， 这 就 是 Java 
的 方法 重 载 机 制 。 方 法 重 载 就 是 同名 方法 ， 但 是 方法 的 参数 数量 或 者 类 型 不 同 2。 
在 代码 中 会 发 现 一 个 问题 ， 每 次 创建 一 个 学 生 对 象 的 时 候 ， 总 是 要 调用 两 次 set 方法 用 于 设 
置 学 生 的 字段 属性 ， 有 没有 什么 办 法 能 够 方便 地 创建 对 象 呢 ? 


1.4.3 初始 化 
对 象 的 初始 化 是 通过 构造 器 实现 的 ， 构 造 器 就 是 与 类 名 相同 并 且 没 有 返回 值 的 那个 方法 。 
如 果 一 个 类 没有 明确 地 编写 构造 器 ， 那 么 编译 器 会 默认 生成 一 个 构造 器 。 构 造 器 可 以 有 多 个 ， 每 
个 构造 器 的 参数 列表 不 同 。 下 面 针 对 Student 类 编写 它 的 构造 器 。 
public Student(int age, String name) { 
this.age = age; 
this.name = name; 


} 


public Student() { 
this.age = 0; 
this.name = "todo"; 
} 
如 果 只 写 上 面 带 参数 的 构造 器 ， 那 么 之 前 编写 的 代码 无 法 正确 编译 ， 因 为 默认 的 构造 器 没 
有 自动 生成 ， 而 之 前 的 代码 都 是 通过 默认 构造 器 创建 的 对 象 ， 所 以 必须 添加 无 参数 的 构造 器 。 
添加 Student 的 构造 器 后 ， 可 以 修改 School 类 的 addStudent 方法 为 : 
public void addStudent(int age,String name) { 
Student student = new Student(age,name); 


addStudent(student); 
/*Student student = new Student(); 


O 方法 返回 值 不 同 不 能 形成 重 载 。 


19 


Java 服务 端 研 发 知识 图 谱 


student.setA ge(age); 
student.setName(name);*/ 
//addStudent(student); 

} 


这 种 调用 构造 器 创建 对 象 的 方法 会 使 代码 更 简洁 ， 同 时 也 保证 程序 的 健壮 ， 和 否则 对 象 中 的 
字段 没有 正确 初始 化 ， 会 在 不 可 知 的 地 方 发 生 问题 。 同 时 也 注意 到 ， 之 前 的 代码 用 包 、*W 和 W 框 
起 来 了 ， 放 和 # 可 以 使 其 中 间 的 代码 失效 ，// 可 以 使 它 后 面 的 代码 失效 。 通 常用 它们 注释 无 用 代 
码 或 者 添加 说 明 性 文字 。 

除了 构造 器 的 方式 ， 也 有 其 他 的 方法 初始 化 字段 的 值 ， 例 如 直接 在 声明 字段 的 时 候 赋 值 ， 
或 者 通过 初始 化 代码 块 来 进行 赋值 。 下 面 演示 这 两 种 写法 。 

public class Student { 
private int age = 18; 
private String name = "todo"; 


public Student() { 
/this.age = 0; 
//this.name = "todo"; 


} 


Er 
© 


public static void main(String[] args) { 
Student student = new Student(); 
//stadent.setA ge(12); 
//student.setName("xiaoming"); 
System.out.println("student age = " + student.getA ge()); 
System.out.println("student name = " + student.getName());; 


} 
运行 结果 如 下 : 
student age= 18 
student name =todo 
以 上 截取 了 部 分 Student 类 修改 后 的 写法 ， 由 输出 可 见 字段 被 设置 了 初始 值 。 下 面 添加 初始 
化 块 ， 再 执行 main 方法 观察 字段 值 最 后 的 输出 结果 。 
public class Student { 


private int age = 18; 
private String name = "todo"; 


{ 
age = 20; 
name = "Construct"; 


} 
运行 结果 如 下 : 


O 本 书 在 代码 段 中 可 能 会 包含 “...” 这 样 的 内 容 ， 这 是 表示 在 书 中 省 略 了 部 分 已 介绍 代码 或 者 get. set 方法 ， 如 果 要 查看 “...” 
表示 的 实际 内 容 ， 可 以 查看 本 书 附带 的 工程 源码 。 
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student age = 20 
student name = Construct 


三 


的 结果 


在 目前 已 


BE 


最 后 的 输出 结果 是 初始 化 块 中 赋值 的 结果 ， 这 里 涉及 了 一 个 初始 化 顺序 的 问题 ， 最 后 赋值 
会 被 打印 出 来 ， 所 以 可 知 初始 化 块 的 执行 时 间 晚 于 变量 
经 介绍 的 内 容 中 ， 初 始 化 顺序 先是 变量 声明 时 的 风 


声明 时 赋值 的 上 
\ 值 ， 然 后 是 初始 化 块 ， 最 后 


构造 器 。 对 于 一 个 普通 的 类 ， 这 个 顺序 是 一 定 的 ， 但 是 当 引 入 前 
的 基础 上 插入 其 他 步骤 。 


1.4.4 This 与 Static 


的 参数 的 值 。3 


static 修饰 的 方法 称 为 静态 方法 。 静 态 方法 与 普通 成 员 方法 不 同 ， 静 态 
以 它 不 能 指 代 调用 的 实例 ， 或 者 说 静态 方法 不 关心 是 哪个 实例 调用 它 ， 它 只 


在 上 面 的 例子 中 ， 使 用 set TREC SID 菜 个 字段 的 值 ， 方 法 里 的 语句 是 thisname = name;。 这 里 
this 的 作用 就 是 指 代 调 用 这 个 方法 的 实例 ， 这 人 句 话 的 意思 就 是 把 调 
普通 成 员 方法 都 是 默认 有 this 的 ， 其 意义 就 是 指 代 调 用 的 实例 。 
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STA. 


faut 


静态 和 继承 之 后 ， 会 在 这 个 顺序 


的 实例 的 name 字段 的 值 设 为 传 入 


下 面 对 Student 类 进行 改造 ， 统 计 创 建 的 学 生 的 人 数 。 
public class Student { 


private int age = 18; 
private String name = "todo"; 


private static int count = 0; 


public static int getCount() { 


return count; 
} 
public Student(int age,String name) { 
count++; 
this.age = age; 
this.name = name; 
} 
public Student() { 
count++; 
this.age = 0; 


this.name = "todo"; 


j 


public static void main(String[] args) { 
for(int i=0;i<10;i++) { 
Student student = new Student(); 


} 


System.out.println("student count = " + Student.getCount()); 


方法 里 没有 this, H 


所 属 的 类 负责 。 
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运行 结果 如 下 : 


student count = 10 


这 里 仪 展示 和 静态 相关 的 内 容 ， 添 加 了 一 个 静态 的 变量 count 和 静态 方法 getCount(). 
每 次 调用 构造 器 时 把 计数 变量 自 增 。 这 样 在 main 方法 中 创建 了 10 个 对 象 后 ， 


确 记录 创建 实例 的 个 数 。 注 意 静 态 方法 的 调用 方式 ， 是 通过 类 名 调 月 


用 的 。 


计数 器 会 正 


HEJ, 而 不 是 通过 实例 调 


对 于 静态 和 非 静 态 的 区 别 ， 只 要 记 住 ， 静 态 变 量 是 属于 类 的 ， 一 个 类 仅 有 一 份 ?; 


不 能 直接 调用 类 里 的 非 静态 变量 和 方法 ， 因 为 非 静 态 的 变量 和 方法 需要 this。 
静态 的 引入 会 对 类 的 构造 顺序 造成 影响 ， 当 第 一 次 使 用 某 个 类 时 ， 会 先 初始 化 类 的 静态 变 


二 个 实例 时 则 不 会 执行 静态 的 构造 ， 


1.4.5 ”访问 权限 


量 然后 执行 静态 初始 化 块 ， 之 后 才 会 按照 上 面 所 讲 的 类 的 构造 顺序 进行 构造 。 当 创建 此 类 的 第 
因为 静态 的 数据 只 构造 一 次 。 


非 静态 变量 


是 属于 实例 的 ， 每 个 实例 一 份 ， 静 态 方法 是 没有 this 的 ， 所 以 不 能 像 普通 方法 那样 调用 ， 静 态 方法 


Java 的 访问 权限 分 为 4 种 ， 分 别 是 公开 访问 权限 、 保 护 访问 权限 、 包 访问 权限 、 私 有 权 
限 。 这 四 种 权限 的 写法 和 使 用 范围 见 表 1-6。 


表 1-6 访问 权限 


权限 名 称 关键 字 权限 范围 法 
公开 访问 权限 publio | 。 所 有 都 可 访问 一 此 希望 别人 使 用 的 方法 或 者 公开 的 API 
Pen Sone il wee 不 项 望 所 有 和 信者 可 以 使 用 ， 但 是 希望 此 方法 子 类 可 以 使 
或 者 更 改 
shes 默认 访问 权限 ， 没 有 关 RE m EN 亲 . 诅 后 | 其 仙 类 可 以 伟 用 它 
包 访问 权限 (default) 健 字 ， 同 一 包 内 可 以 访问 民 于 同一 包 内 ， 仅 希望 同一 个 包 里 的 其 他 类 可 以 使 用 它 
全 本 类 里 的 完全 私有 方法 ， 包 含 类 的 对 象 都 不 可 以 调用 ， 
HALL 类 dL Afi 
ala Private | 仪 己 类 内 部 可 以 使 用 T 般 用 于 实现 类 的 私有 能 力 ， 并 不 对 外 开放 
关于 权限 的 使 用 不 再 举例 ， 前 面 的 例子 中 已 经 大 量 使 用 了 权限 设置 。 一 般 来 讲 注意 以 下 几 


点 即 可 : 不 要 把 字段 设 为 public 权限 ， 要 分 配 正确 的 get 和 set 方法 ; 不 要 把 所 有 方法 都 设 为 


public， 要 适当 地 对 外 暴露 方法 ， 除 
权限 设置 ，protected 权限 需要 明确 类 


1.4.6 “垃圾 回收 


动 回收 的 机 


i 


清理 的 相关 资料 。 


O 设计 模式 中 的 单 例 模式 就 是 通过 静态 实现 
22 


FE 明确 包 访 问 权 限 的 用 意 ， 和 否则 一 定 要 合理 分 本 


前 面 用 大 量 的 篇 幅 讲解 了 如 何 创建 一 个 实例 以 及 如 何 使 
之 后 去 了 哪里 呢 ? 这 个 问题 对 于 C++ 语言 来 说 是 必须 解决 的 ， 如 果 用 C++ 语言 创建 完 对 象 后 置 
之 不 理 ， 整 个 程序 肯定 会 骨 溃 。 但 是 这 个 问题 对 于 Java 来 讲 就 没有 那么 重要 了 ，Java 有 一 套 
于 处 理 创建 出 来 的 实例 ， 而 本 书 所 涉及 的 内 容 基 本 都 不 需要 手动 ; 


际 使 用 中 真正 需要 手动 清理 的 地 方 也 很 少 ， 所 以 就 不 再 袭 述 ， 有 兴趣 的 读者 可 以 查阅 关于 Java 


uN TEEN 


的 继承 关系 时 再 使 用 ， 和 否则 这 个 权限 等 同 于 private. 


j 这 个 实例 。 但 是 这 些 实例 使 用 完 


g 


JHR, K 


的 。 
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1.5 ”继承 和 多 态 


继承 是 指派 生 类 继承 基 类 的 属性 和 某 些 行为 ， 多 态 是 指派 生 类 在 基 类 的 基础 上 进行 重 写 从 
而 表现 出 来 的 不 同性 状 。 本 节 从 基础 的 Object 和 类 似 的 组 合 讲 起， 一 点 点 了 解 继承 和 多 态 的 原 
理 和 用 法 。 
1.5.1 Object 

前 面 编 号 了 好 多 代码 用 来 创建 类 对 象 以 及 调用 相应 的 方法 ， 但 是 类 不 仅仅 是 这 些 内 容 。 观 
察 下 面 代码 的 和 输出， 了解 类 和 对 象 的 其 他 特性 。 
public class Person { 


public long id; 
public String name; 


public Person(long id,String name) { 
this.id = id; 
this.name = name; 


} 


public static void main(String[] args) { 
Person person = new Person(1, "xiaoming"); 
System.out.printIn(person.toString()); 


com.javadevmap.Person@7852e922 


这 里 使 用 了 public 的 字段 ， 是 为 了 使 代码 看 起 来 简单 一 些 ， 实 际 项 目 中 不 这 样 使 用 。 在 这 
个 例子 中 ， 创 建 了 一 个 person 对 象 ， 然 后 调用 了 toString0 方 法 ， 但 是 类 里 并 没有 这 个 方法 ， 这 
个 方法 是 从 哪里 来 的 呢 ? 

这 就 涉及 Java 的 单 根 继承 结构 。 在 Java 中 ， 所 有 的 类 都 继承 自 Object 类 。 也 就 是 说 除了 其 
本 类 型 ， 其 他 类 都 是 一 种 Object。 而 toString 方法 就 是 Object 里 的 方法 ， 通 过 类 的 继承 而 来 。 这 
种 单 根 继 承 结构 也 为 Java 的 内 存 回 收 提供 了 很 大 的 便利 。 
继承 听 起 来 很 费解 ， 举 个 例子 。 例 如 常用 的 手机 是 一 种 物质 ， 看 不 见 的 原子 也 是 一 种 物 
质 ， 那 么 把 这 些 东 西 的 通用 性 全 部 抽 离 出 来 ， 用 物质 这 个 统称 来 代替 它们 是 可 以 的 。 对 于 Java 
语言 ， 这 个 统称 就 是 Object， 所 有 物质 包含 的 属性 ， 例 如 大 小 ， 重 量 就 相当 于 Object 里 的 字段 或 方 
法 。 而 继承 就 是 在 这 个 统称 之 上 再 进行 细 分 ， 从 而 凸显 自己 的 特性 。 

再 回 到 代码 中 ，toString 方法 其 实 是 把 类 的 内 容 转化 为 String 进行 输出 ， 但 好 像 并 没有 得 到 
期 望 答 出 的 内 容 93。 是 否 可 以 通过 某 种 办 法 输出 期 望 的 数据 ?代码 如 下 : 

@Override 


public String toString() { 
return "id=" + this.id + " name =" + this.name; 


T 


} 


© toString 的 默认 输出 这 里 不 再 介绍 ， 请 查阅 相关 资料 。 
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运行 结果 如 下 : 
id = | name = xiaoming 


可 以 在 Person 类 中 重 写 这 个 方法 ， 用 于 替换 Object 的 默认 toString 实现 ， 从 而 达到 正确 输 
出 的 目的 。 
Object 还 有 一 个 equals0 方 法 ， 用 于 对 象 的 比较 。 通 过 下 面 的 代码 演示 这 个 方法 的 使 用 。 首 
先 不 重 写 此 方法 ， 观 察 输出 的 结果 。 
public static void main(String[] args) { 
Person person! = new Person(1, "xiaoming"); 
Person person2 = new Person(1, "xiaoming"); 
System.out.printIn("person 1 = person 2 =" + (person! = person2)); 
System.out.printIn("person 1 equals person 2 =" + (person1 .equals(person2))); 


} 

运行 结果 如 下 : 
person 1 == person 2 = false 
person 1 equals person 2 = false 


虽然 代码 中 给 创建 的 两 个 对 象 赋 的 值 是 相同 的 ， 但 是 无 论 用 “一 ”比较 还 是 用 equals 比 
较 ， 比 较 的 结果 都 是 不 同 的 。 下 面 重 写 equals 方法 ， 再 执行 程序 观察 输出 的 结果 。 
@Override 
public boolean equals(Object obj) { 
if(obj == null) { 
return false; 


} 

Person person = (Person)obj; 

if((this.id = person.id) && (this.name==person.name)) { 
return true; 

} 


return false; 


person 1 == person 2 = false 
person 1 equals person 2 = true 


通过 重 写 equals 方法 ， 对 对 象 里 的 字段 值 进行 比较 ， 字 段 值 相同 即 两 个 对 象 相同 ， 最 后 两 
个 对 象 比较 的 结果 是 tue。 那 么 为 什么 “一 ”比较 的 结果 还 是 false 呢 ? 其 实 “==” 比 较 的 是 对 
象 的 地 址 ， 两 个 对 象 地 址 不 同 所 以 不 同 ，equals 默认 的 方法 比较 的 也 是 对 象 的 地 址 ， 需 要 履 盖 
equals 的 默认 实现 才能 正确 进行 比较 。 


1.5.2 AA 
在 了 解 继 承 之 前 ， 先 弄 清楚 什么 是 组 合 。 正 如 前 面 章 节 所 讲 ， 手 机 相对 于 物质 来 讲 ， 属 于 


继承 关系 ， 它 继承 了 物质 这 个 大 概念 下 的 一 些 属性 ， 手 机 相对 于 触摸 屏 来 讲 ， 属 于 包含 关系 ， 
这 个 包含 叫 作 组 合 。 在 之 前 的 Person 类 中 写 一 个 内 部 类 SEyes， 添 加 一 个 Eyes 的 实例 为 person 


O 内 部 类 是 指 在 一 个 类 中 、 方 法 中 或 者 表达 式 中 等 非 文件 最 外 层 范 围 定义 的 类 ， 普 通 内 部 类 由 于 定义 在 其 他 类 的 内 部 作用 域 中 ， 
所 以 其 含有 一 些 特性 ， 例 如 可 以 访问 外 层 类 的 字段 等 ， 大 部 分 内 部 类 是 为 了 简化 代码 实现 等 目的 才 使 用 的 ;静态 内 部 类 比较 特殊 ， 它 的 
能 力 没有 被 外 部 类 所 限制 ， 类 似 于 外 部 类 的 能 力 。 内 部 类 的 内 容 也 比较 多 ， 建 议 读者 自行 了 解 。 
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的 字段 。 
public class Person { 
public long id; 
public String name; 
public Eyes eyes = new Eyes(); 
public static class Eyes { 
public String left = "Zuoyan"; 
public String right = "youyan"; 
} 
} 
在 这 个 例子 中 ， 用 Person 包含 了 一 个 静态 内 部 类 的 实例 ， 当 然 Person 也 可 以 包含 非 内 部 类 


的 实例 ， 这 里 这 样 写 是 为 了 展示 方便 。Person 是 对 一 个 事物 的 抽象 ， 但 是 这 个 事物 是 由 很 多 部 
分 组 成 的 ， 每 个 部 分 也 可 以 抽象 出 来 ， 最 后 在 Person 中 组 合 在 一 起 。 
在 实际 项 目 中 组 合 的 应 用 是 非常 多 的 ， 当 组 装 业 务 罗 辑 的 时 候 ， 常 常会 把 数据 库 的 操作 类 
实例 、 对 外 服务 调用 的 操作 类 实例 等 和 业务 相关 的 类 实例 组 合 在 一 起 以 实现 业务 逻辑 。 
1.5.3 继承 

如 前 面 所 讲 ， 继 承 是 在 同一 种 共性 基础 上 的 细 分 和 丰富 。 在 基 类 中 定义 此 类 事物 的 共性 ， 
在 派生 类 中 对 基 类 中 定义 的 共性 进行 具体 的 实现 或 者 修改 ， 并 且 添 加 自己 的 特性 。 下 面 通过 动 
物 的 例子 来 说 明 这 个 问题 。 


public class Animal { 
public int weight; 


public Animal(int weight) { 
this.weight = weight; 


} 


public void move() { 
System.out.println("animal can move!"); 
j 
} 


public class Tiger extends Animal { 


public String roar = "ao"; 

public Tiger(int weight,String roar) { 
super(weight); 
this.roar = roar; 


j 


@Override 
public void move() { 
System.out.println("tiger can run!"); 


} 


25 


Java 服务 端 研 发 知识 


代码 


move()。 然 后 


图 谱 


己 的 特性 roar, JF AF 


类 构造 的 属性 。 


先 定 义 了 动物 的 基 类 Animal， 在 基 类 中 定义 了 动物 
在 派生 类 Tiger 中 通过 extends 关键 字 
E 写 OT 了 基 类 的 move0 方 法 


public static void main(String[] args) { 
Tiger tiger = new Tiger(500, "ao!"); 
tiger.move(); 


System.out.println("tiger weight = 


Animal animal = new Animal(1000); 
animal.move(); 


System.out.println("animal weight = 


} 
运行 结果 如 下 : 


tiger can runl 


tiger weight = 500 tiger roar = ao! 


animal can move! 
animal weight = 1000 


上 面 代码 中 创建 了 Tiger 类 的 实际 对 象 ， 其 不 仅 包含 


段 ， 并 且 move0 方 法 
引入 了 继承 后 ， 


原则 是 先 构 造 此 派生 类 的 基 类 
类 和 基 类 中 都 包含 静态 字段 时 ， 
方法 ， 验 证 这 种 情况 的 构造 顺序 。 


1. 5, 4 多 态 


有 不 同 的 表现 。 
一 个 对 象 的 构造 | 


"+ animal.weight); 


共有 的 属性 weight 和 方法 
声明 此 类 继承 了 Animal 基 类 ， 添 加 Tiger 自 


。 在 派生 类 的 构造 器 ， 


对 


通过 super 传递 需要 基 


"+ tiger.weight + " tiger roar = " + tiger.roar); 


部 分 ， 


E ene 


新 定义 的 字段 ， 还 包含 了 基 类 的 字 


抽 序 又 变 得 更 加 复杂 了 ， 当 创建 一 个 派生 类 对 和 象 的 时 候 ， 
再 构造 派生 类 新 定义 的 部 分 。 


那么 设想 一 个 问题 ， 当 派生 


希望 读者 自 


己 动手 ， 设 计 一 个 


说 到 多 态 就 不 得 不 说 动态 绑 定 ， 


现 基于 动态 绑 定 ， 是 指 
法 还 是 派生 类 的 方法 


。 基 于 上 面 的 例子 ， 再 添加 


public class Fish extends Animal { 


日 基 类 的 引用 指向 派生 类 的 实例 ， 当 调 


毕竟 编程 不 是 背 概念 ， 自 己 


动态 绑 定 是 指 在 执行 时 判 


L 


public String livein = "water"; 


public Fish(int weight,String livein) { 
super(weight); 
this. livein = livein; 


} 


@Override 
public void 


move() { 


System.out.printin("fish can swim!"); 


j 


O RARE SUN ATI ET RY 


村 性 ， 此 方法 会 
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LEE, 


断 所 作用 对 象 的 实际 类 型 。 
用 方法 时 再 
个 派生 类 Fish 来 说 明 这 个 问题 。 


动手 才能 丰衣足食 。 


多 态 的 实 


定 是 应 该 调用 基 类 的 方 


但 子 类 的 特性 没有 很 好 地 表现 ， 


这 种 情况 下 子 类 一 般 重 写 这 个 方法 以 突显 子 类 的 


派生 类 Fish 继承 
Fish 这 3 个 类 的 实例 ， 


进行 操作 3 


观察 


基 类 Animal, JFE 
然后 把 它们 加 入 同一 个 数组 ， 最 后 月 
结果 。 


public static void main(String[] args) { 


Animal animal = new Animal(1000); 
Tiger tiger = new Tiger(500, "ao!"); 
Fish fish = new Fish(10, "water"); 


Animal 
animals 
animals 
animals 


Fe 


] animals = new Animal[3]; 
0] = animal; 

1] = tiger; 

2] = fish; 


SS 


for(Animal temp:animals) { 
System.out.println("animal weight = " + temp.weight); 


重 写 了 move0 方 法 。 
J Animal 的 类 


下 面 分 别 创建 Animal、 
型 分 别 引 用 这 3 个 实例 


Ako > 
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Tiger、 


temp.move(); 
} 
} 
运行 结果 如 下 ; 
animal weight = 1000 
animal can move! 
animal weight = 500 
tiger can run! 
animal weight = 10 
fish can swim! 

在 这 段 代 码 的 for 循环 中 ， 都 是 用 Animal 类 型 的 引用 指 代数 组 中 的 实例 ， 但 是 在 调用 
move0 方 法 时 却 有 不 同 的 表现 ， 这 就 是 多 态 。 多 态 是 用 基 类 指 代 派 生 类 ， 在 实际 调用 时 调用 派生 
类 的 实现 。 通 过 基 类 的 引用 可 以 调用 在 基 类 中 定义 的 字段 ， 例 如 weight， 但 是 不 能 使 用 在 派生 
类 中 添加 的 字段 。 


15.5 ”接口 


NZ 


设想 一 种 情况 ， 


当 把 一 组 Tiger 类 的 实例 放 入 一 个 容 
么 办 ? 一 个 标准 的 容器 是 有 


从 小 到 大 进行 排 
较 ， 这 个 比较 方法 需要 通过 Tiger 类 来 提 化 


IBZ 


F 


器 (List) | 
sort()#] 


FE 序 方法 的 ， 


H 


， 和 希望 按照 每 个 实例 的 重量 


排序 需要 基于 大 小 的 比 


Yo 


用 的 引用 来 指 
AB BEAD H.F 
实现 对 象 通用 能 


看 容器 的 


由 于 Java 的 单 根 继 承 结 
能 力 又 不 能 全 部 封装 进 Object 基 类 
类 ; 在 这 种 情况 下 ， 
通用 的 容器 就 可 以 用 这 个 接口 
排序 是 怎 么 实现 的 。 


代 


需要 对 非常 多 的 这 种 ee 法 。 
的 引用 ， 这 就 是 接 
吉 构 ， 所 以 没 


IB CHP 
;一 些 通 / 


寺 装 一 些 通用 的 能 


通过 接口 3 


二] 


但 是 容器 都 是 通 上 
k 体 的 对 象 ， 而 这 种 引用 又 不 适合 于 使 用 Object, 


的 ， 在 比较 的 时 候 容器 需要 
因为 如 果 那 样 
因此 需要 有 一 种 机 制 对 和 


个 通 
的 话 ，Object 将 会 
E 力 进行 说 明 ， 并 且 


F 通 过 多 重 继 承 来 引入 更 多 的 能 力 ， 而 一 些 


j 的 容器 却 又 需要 一 种 通用 的 引 


用 来 指 代 不 同 的 


， 有 具体 的 类 继承 接 


并 且 实 现 这 种 能 力 ， 


Be 
具体 的 类 实例 进行 比较 了 。 


Sl. 


IAN 


: 口 类 不 


可 以 实例 化 ， 并 且 它 不 会 影响 Java 的 单 根 继承 结构 。 


下 面 提前 


透露 容器 的 内 容 ， 来 看 
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public class Tiger extends Animal implements Comparable<Tiger> { 
public String roar = "ao"; 


public Tiger(int weight,String roar) { 
super(weight); 
this.roar = roar; 


} 


@Override 
public void move() { 
System.out.println("tiger can run!"); 


} 


@Override 
public String toString() { 
return "the tiger weight is " + weight; 


j 


@Override 
public int compareTo(Tiger o) { 
if(this.weight < o.weight) { 
return —1; 
else if(this. weight = o.weight) { 
return 0; 
yelse { 
return 1; 
} 
} 


public static void main(String[] args) { 
Tiger tigerl = new Tiger(498, "ao!"); 
Tiger tiger2 = new Tiger(430, "ao!"); 
Tiger tiger3 = new Tiger(500, "ao!"); 
Tiger tiger4 = new Tiger(488, "ao!"); 
Tiger tiger5 = new Tiger(590, "ao!"); 
List<Tiger> list = new ArrayList<Tiger>(); 
list.add(tiger1); 
list.add(tiger2); 
list.add(tiger3); 
list.add(tiger4); 
list.add(tiger5); 
System.out.printin("sort before " + list); 
Collections.sort(list); 
System.out.println("sort after " + list); 


运行 结果 如 下 : 
sort before [the tiger weight is 498, the tiger weight is 430, the tiger weight is 500, the tiger weight is 488, 
the tiger weight is 590] 


sort after [the tiger weight is 430, the tiger weight is 488, the tiger weight is 498, the tiger weight is 500, 
the tiger weight is 590] 
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1.5.6 ”抽象 类 


Comparable ! 


实例 间 的 比较 方式 ， 这 样 当 把 一 


组 实例 


Ako se 


F 1# 
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的 compareTo0 方 法 ， 此 方法 会 允许 继承 此 接口 的 类 定义 
放 入 容器 后 ， 通 过 Collections.sort(list) 即 可 快速 排序 。 


抽象 类 简单 来 讲 ， 就 是 不 可 创建 实例 的 基 类 。 在 之 前 的 例子 中 ， 如 果 在 Animal 类 的 class 
前 面 添加 一 个 abstract 关键 字 ， 会 发 现 之 前 创建 Animal 实例 的 地 方 都 报错 了 。 抽 象 类 的 定义 取 
决 于 程序 的 设计 ， 设 计 者 希望 Animal 类 作为 基 类 可 以 指 代 派 生出 来 的 所 有 动物 ， 同 时 不 希望 创 
建 一 个 之 无 意义 的 仅仅 叫 作 动物 的 实例 〈 而 不 知道 具体 的 类 型 )， 这 种 情况 下 ， 会 把 基 类 定义 为 
抽象 类 。 

在 抽象 类 中 ， 可 以 定义 抽象 方法 ， 就 是 在 方法 的 前 面 添加 abstract， 并 且 没 有 方法 的 实现 。 
抽象 方法 要 求 派生 类 必须 实现 此 方法 。 例 如 修改 之 前 的 Animal 类 ， 观 察 它 的 派生 类 的 
变化 。 

public abstract class Animal { 
public int weight; 
public Animal(int weight) { 
this. weight = weight; 
} 
public void move() { 
System.out.printIn("animal can move!"); 
} 
public abstract void eat(); 
} 

TEJE! a 象 方法 eat0， 如 果 不 修改 它 的 派生 类 ， 派 生 类 会 报错 ， 要 求实 现 此 方法 。 
是 否 使 用 抽象 类 还 需要 在 实际 项 目 中 根据 具体 情况 进行 选择 。 

16 容器 

容器 是 存放 对 象 的 地 方 ， 当 大 量 的 对 象 需要 在 内 存 中 存在 ， 并 且 单 个 对 象 分 别 使 用 很 不 方 
便 的 时 候 ， 就 是 容器 应 用 的 场景 了 。Java 存放 数据 的 方式 有 很 多 种 ， 例 如 固定 大 小 的 数据 以 及 
可 以 自动 调整 大 小 的 容器 类 。 而 容器 类 经 过 Java 多 个 版 本 的 迭代 ， 继 承 关系 较为 复杂 ， 有 些 容 
器 已 经 建议 废弃 ， 前 比较 党 用 的 就 是 List、Set、Map， 本 节 将 一 一 使 用 它们 并 且 了 解 它们 的 


基础 用 法 。 在 介绍 容器 类 2 
1.6.1 数组 


数组 相对 于 容器 类 
有 length 字段 ，| 


前 先 看 看 数组 。 


， 效 率 更 高 ?， 但 缺点 也 很 明显 ， 在 生命 
] 于 访问 数组 的 大 小 。 


“D wei ay 


a 例如 用 new 创建 或 者 


下 面 分 别 演 示 数 组 的 这 些 用 法 。 


O 如 果 追 求 极 限 


， 数 组 确实 效率 更 高 ， 


如 果 只 是 


般 的 应 


周期 内 不 可 改变 数组 大 小 。 
以 访问 组 数 成 员 。 
直接 填写 数组 元 素 。 数 组 


数组 


数组 的 创建 也 有 多 种 方 


还 有 多 维 的 能 力 ， 可 以 创建 二 维 以 上 的 数 


， 其 实效 率 的 体现 并 没有 特别 重要 的 意义 。 
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(1) 一 维 数组 


public class JavaArray { 
public static void testDirectConArray() { 
String[] strings = {"hilei","hanmeimei","lucy"}; 


System.out.println("array length = " + strings.length); 


System.out.printIn(Arrays.asList(strings)); 
} 


public static void testNewConArray() { 
String[] strings = new String[5]; 
strings[0] = "A"; 
strings[1] = "B"; 
strings[2] = "C"; 
strings[3] = "D"; 


System.out.println("array length = " + strings.length); 


System.out.println(Arrays.asList(strings)); 


} 

public static void main(String[] args) { 
testDirectConArray(); 
testNewConArray(); 


运行 结果 如 下 : 
array length = 3 
[lilei, hanmeimei, lucy] 
array length = 5 
[A, B, C, D, null] 


代码 中 使 用 了 两 个 方法 ， 每 个 方法 使 用 不 同 的 方式 创建 一 维 数组 。 在 第 
直接 赋值 的 方式 初始 化 数组 ， 并 且 在 打印 时 使 用 Arrays.asList0 方 法 将 数组 转化 为 List 进行 打 
印 。 如 果 不 使 用 此 方法 ， 可 以 采用 直接 打印 的 方式 打印 数组 ， 看 看 结果 是 否 如 期 望 的 那样 ， 并 
STH, 并 且 
组 空间 是 5 个 ， 而 实际 具 赋 值 了 4 个 ， 但 是 打印 时 还 是 打印 出 了 第 


考虑 一 下 为 什么 。 在 第 二 种 方法 中 采用 new 来 创建 数组 空 


(2) 二 维 数组 


public static void testT'dimArray() { 


一 种 方法 中 ， 采 用 


逐个 赋值 


五 个 空 元 素 。 


。 方 法 中 创建 的 数 


String[][] strings = {{"one"","two","three"}, {"four","five","six"},{"seven","eight","nine"}}; 


for(String[] tempStrings:strings) { 
System.out.println(Arrays.asList(tempStrings)); 
j 
} 


public static void testNewTidmArray() { 
String[][] strings = new String[2][]; 
strings[0] = new String[2]; 
strings[1] = new String[4]; 
strings[0][0] = "up"; 
strings[0][1] = "down"; 
strings[1][0] = "east"; 
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strings[1][1] = "south"; 
strings[1][2] = "west"; 
strings[1][3] = "north"; 
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for(String[] tempStrings:strings) { 
System.out.println(Arrays.asList(tempStrings)); 


} 
} 
public static void main(String[] args) { 

// testDirectConArray(); 

// testNewConArray(); 
testTdimArray(); 
testNewTidmArray(); 

} 
运行 结果 如 下 : 


one, two, three] 
four, five, six] 


up, down] 


[ 
[ 
[seven, eight, nine] 
[ 
[ 


east, south, west, north] 


代码 中 使 用 两 种 方式 创建 二 维 
杠 套 的 数组 大 小 可 


了 一 个 维度 ; tik 


1.6.2 List 


ArrayList， 一 种 是 链表 


数组 ， 二 维 数组 和 一 维 数组 的 使 用 没有 太 大 分 别 ， 只 是 多 加 


可 以 保持 统一 或 者 自 定 义 不 同 的 大 小 。 
数组 的 使 用 和 功能 简单 ， 昌 然 有 效率 高 的 优点 ， 但 是 一 般 的 业务 届 辑 很 难 体现 其 优势 ， 通 
常情 况 下 一 般 使 用 容器 类 来 代 蔡 数 组 的 使 用 。 


容器 List 其 实 就 是 一 个 列表 ， 但 是 Java 对 列表 的 实现 分 为 两 种 ， 一 种 是 类 似 数组 的 实现 


的 实现 LinkedList。 这 两 种 List 都 可 以 通过 List 类 进行 引用 并 且 调 用 方 
法 ， 只 是 由 于 内 部 实现 的 不 同 存在 性 能 上 的 差异 ，ArrayList 在 插入 方面 不 如 LinkedList, 


LinkedList 在 获取 列表 


能 差别 ， 这 里 就 不 过 多 介绍 了 ， 仅 介绍 List 的 基本 用 法 。 


(1) ArrayList 


WIEN 


FE 能 不 如 ArrayList。 可 以 设计 实验 方法 来 检验 这 两 种 List 的 性 


public static void testArrayList() { 
List<String> list = new ArrayList<String>(); 
list.add("one"); 
list.add("two"); 
list.add("three"); 
list.add("four"); 
System.out.println(list); 
System.out.printin(list.get(3)); 
listremove("four"); 
System.out.println(list); 
System.out.println("List contains one is " + list.contains("one")); 
list.add("five"); 
list.set(3, "four"); 
System.out.println(list); 
System.out.println("List index of two is " + list.indexOf("two")); 
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System.out.println("sub list is " + list.subList(1, 3)); 
if(!list.isEmpty()) { 
Object[] strings = list.toArray(); 
System.out.println("array length is " + strings.length); 


[one, two, three, four] 
four 

[one, two, three] 

list contains one is true 
[one, two, three, four] 
list index of two is 1 
sub list is [two, three] 
array length is 4 


在 上 面 的 例子 中 ， 使 用 了 常用 的 List 方法 ， 添 加 、 删 除 、 包 含 判 断 、 设 置 值 、 查 询 索 引 、 
生成 子 List、 转 为 数组 等 。List 的 使 用 还 有 很 多 其 他 方法 ， 大 家 可 以 查看 类 文档 进行 了 解 。List 
的 遍历 可 以 用 foreach 的 形式 ， 也 可 以 用 迭代 器 的 形式 ， 下 面 代码 演示 LinkedList 和 迭代 器 如 何 
配合 使 用 。 

(2) LinkedList 


public static void testLinkedList() { 

String[ | strings = {"one","two","three","four","five","six","seven","eight","nine","ten'"}; 
List<String> list = new LinkedList<String>(); 
list-addAll(Arrays.asList(strings)); 
Iterator<String> it = list.iterator(); 
while(it-hasNext()) { 

String string = it.next(); 

if(string—="three" || string=="six" || string—="nine") { 

it-remove(); 


} 
} 


System.out.println(list); 


} 
运行 结果 如 下 : 
[one, two, four, five, seven, eight, ten] 
这 个 例子 运用 迭代 器 对 List PETIT, Cea AN RE PHL SpE ORE TT Et 
除 List 中 不 需要 的 内 容 ， 很 好 地 利用 了 LinkedList 方便 增删 数据 的 特性 


o 


1.6.3 Set 

Set 是 一 个 集合 ， 它 不 保证 存 取 的 顺序 2， 它 的 主要 特性 就 是 存储 值 的 唯一 性 ， 重 复 的 添加 
操作 对 Set 无 用 ， 集 合 中 只 会 存储 一 份 数据 。 要 判断 存储 的 对 象 是 否 相 等 ， 可 使 用 equals 和 
hashCode 方法 。 本 节 主 要 介绍 两 种 Set， 分 别 是 HashSet 和 TreeSet。 


= 


O 如 果 必 须 保 证 存储 的 顺序 ， 则 有 额外 的 开销 ， 例 如 使 用 LinkedHashSet， 它 用 一 个 链表 来 维护 顺序 。 
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(1) HashSet 


public class Person { 
public long id; 
public String name; 


@Override 
public boolean equals(Object obj) { 
if(obj == null) { 
return false; 
} 
Person person = (Person)obj; 
if((this.id = person.id) && (this.name==person.name)) { 
return true; 
} 


return false; 


j 


@Override 
public int hashCode() { 
return (int) this.id; 
} 
} 


public class JavaSet { 
public static void testSet() { 
Set set = new HashSet<>(); 
set.add(new Person(1, "lilei")); 
set.add(new Person(2, "hanmeimei")); 
set.add(new Person(3, "lucy")); 
set.add(new Person(3, "lucy")); 
System.out.println(set); 
set.remove(new Person(2, "hanmeimei")); 
System.out.println(set); 
Iterator iterator = set.iterator(); 
while (iterator. hasNext()) { 
Object object = iterator.next(); 
if(object instanceof Person) { 
System.out.println("it is a person and " + object); 


} 
j 


public static void main(String[] args) { 
testSet(); 
j 
} 


运行 结果 如 下 : 
{id = 1name= lilei, id = 2 name = hanmeimei, id = 3 name = lucy] 
{id = 1 name = lilei, id = 3 name = lucy] 


it is a person and id = 1 name = lilei 
it is a person and id = 3 name = lucy 
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对 之 前 实现 的 Person 类 添加 hashCode 方法 。 使 用 HashSet 作为 集合 容器 ， 
对象 的 快速 读 取 ， 通 过 hashCode 和 equals 方法 保 订 
E 复 添加 对 和 象 的 时 候 Set 中 并 没有 出 现 重复 的 内 容 。Set 包含 的 方法 很 
于 判断 一 个 集合 是 否 包 含 某 个 对 象 。 读 者 可 以 在 编写 


Person 的 实例 。HashSet 
对 象 不 会 重复 ， 所 以 当 习 
多 ， 例 如 contains0 就 是 一 个 常用 方法 ，| 
代码 时 了 解 Set 其 他 方法 的 具 


体 用 法 。 


这 个 例子 中 使 用 Set 的 写法 和 之 前 的 List 写法 并 不 相同 ，Set 
这 种 情况 下 当 遍 历 集合 中 的 对 象 时 ， 并 不 知道 集合 中 


的 类 型 ， 


通过 Hash 算法 保 订 


的 


HRA 


ay) 


mm Oo 


后 面 的 之 符号 中 没有 添加 具体 
具体 对 象 类 型 ， 


oT 


所 以 需要 使 用 


instanceof 动态 判断 对 象 的 类 型 (当然 也 可 以 使 用 强制 转换 类 型 )， 而 如 果 使 用 在 二 中 添加 类 型 


的 写法 则 不 ) 


进行 这 种 判断 ， 这 种 写法 称 为 泛 型 


(2) TreeSet 


public static void testTreeSet() { 
TreeSet<Person> set = new TreeSet<>(new Comparator<Person>() { 


@Override 


， 后 面 的 章节 会 有 介绍 。 


public int compare(Person 01, Person 02) { 


这 ol.id < 02.id) { 
return —1; 
yelse if(ol.id == 02.id) { 
return 0; 
yelse { 
return 1; 
} 
} 
3) 
set.add(new Person(40, "xiaoming")); 
set.add(new Person(29, "xiaoming")); 
set.add(new Person(41, "xiaoming")); 
set.add(new Person(32, "xiaoming")); 
set.add(new Person(50, "xiaoming")); 
set.add(new Person(37, "xiaoming")); 
System.out.printin(set); 


} 
TARW F: 


[id = 29 name = xiaoming, id = 32 name = xiaoming, id = 37 name = xiaoming, id = 40 name = xiaoming, 
id = 41 name = xiaoming, id = 50 name = xiaoming] 


TreeSet 是 一 种 可 排序 的 Set， 代 码 中 没有 采用 之 前 的 让 对 象 实现 接 


1.6.4 


Map 


Map 是 通过 键 值 对 存储 的 ， 可 以 通过 键 来 获取 值 。HashMap 是 最 常 
解 Map 的 原理 和 实现 。HashMap 通过 散 列 的 


bili 
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直接 采用 对 Set 设置 比较 方法 来 进行 排序 ， 这 两 种 方法 都 可 以 实现 排序 的 
作为 泛 型 的 类 型 ， 
出 了 一 个 有 序 的 集合 数据 。 


从 而 排序 的 方法 ， 而 


能 力 。 在 这 里 用 Person 
所 以 在 内 部 类 中 可 以 直接 进行 对 象 的 比较 而 不 用 进行 类 型 转换 。 方 法 最 后 输 


HAY Map, KEEN 


EI VAI PARRE E 


目的 。 以 
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机 号 为 例 ， 用 手机 号 对 10000 取 余 ， 那 么 所 有 手机 号 就 散 列 了 10000 个 分 组 ， 分 别 是 从 0 到 
9999， 这 种 散 列 的 基础 就 是 hashCode 方法 。 散 列 后 手机 号 映射 到 的 分 组 值 会 重复 ， 要 把 这 些 散 
列 后 重复 的 数据 保存 到 某 一 分 组 中 就 用 到 了 和 链表， 在 链表 中 要 正确 地 取 值 就 需要 equals 方法 作 
为 对 象 的 比较 依据 。 这 就 是 作为 HashMap 的 Key 值 的 类 为 什么 必须 实现 hashCode 和 equals 这 
两 个 方法 的 原因 ， 见 表 1-7。 


nl 


表 1-7 散 列 情况 


0 138xxxx0000->139xxxx0000->137xxxx0000 
1 138xxxx0001->139xxxx0001->137xxxx0001 
2 138xxxx0002->139xxxx0002->137xxxx0002 
9997 
9998 
9999 138xxxx9999->139xxxx9999->137xxxx9999 
代码 如 下 : 


public static void testHashMapO { 
HashMap<Person, String> map = new HashMap<>(); 
map.put(new Person(1,"xiaoming"), "Musician"); 
map.put(new Person(1,"xiaoming"), "Musician"; 
map.put(new Person(2,"daming"), Scientist"); 
map.put(new Person(3,"xiaobai"), Astronaut"); 
System.out.println(map); 


for(Map.Entry<Person, String> entry : map.entrySet()) { 
System.out.println("key = " + entry.getKey() + " value =" + entry.getValue()); 
j 


for(Person person : map.keySet()) { 
System.out.println(person); 


} 


for(String string : map.values()) { 
System.out.println(string); 


} 


Iterator<Map.Entry<Person, String>> its = map.entrySet().iterator(); 
while (its.hasNext()) { 
Map.Entry<Person, String> entry = its.next(); 
System.out.println("key = " + entry.getKey() + " value =" + entry.getValue()); 


a 


运行 结果 如 下 : 
{id = 1 name = xiaoming=Musician, id = 2 name = daming=Scientist, id = 3 name = xiaobai=Astronaut} 
key = id = 1 name = xiaoming value = Musician 
key = id = 2 name = daming value = Scientist 
key = id = 3 name = xiaobai value = Astronaut 
id= | name = xiaoming 
id = 2 name = daming 
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id = 3 name = xiaobai 

Musician 

Scientist 

Astronaut 

key = id = 1 name = xiaoming value = Musician 

key = id = 2 name = daming value = Scientist 

key = id = 3 name = xiaobai value = Astronaut 
在 上 面 的 例子 中 ， 构 建 了 一 个 HashMap, key 值 是 之 前 经 常 使 用 的 Person 类 对 象 ， 当 然 可 
以 构建 key 值 是 基本 类 型 包装 器 类 的 对 象 ， 具 体 使 用 什么 作为 Key 需要 在 实际 项 目 中 进行 判 
断 ， 这 里 仅 作 为 演示 。 代 码 中 提供 了 几 种 遍历 HashMap 的 方法 ， 包 含 全 量 遍历 HashMap, Rii 
Ji Key 和 只 遍历 Value。 一 些 其 他 方法 这 里 就 不 过 多 介绍 ， 读 者 可 查看 相关 文档 进行 了 解 。 
节 已 经 演示 了 常用 容器 的 使 用 方法 并 介绍 了 容器 的 不 同 特性 ， 在 实际 的 项 目 中 需要 根据 业务 
的 要 求 和 容器 的 特性 选择 合适 的 容器 。 容 器 性 能 问题 一 般 不 会 对 业务 造成 太 多 困扰 ， 除 非特 殊 的 业 
务 罗 和 辑 ， 一 般 都 不 会 遇 到 容器 性 能 瓶颈 。 


1.7 泛 型 


正如 前 面 例子 所 写 ， 其 实 泛 型 最 常见 的 使 用 场景 就 是 在 容器 内 ， 容 器 提供 了 存储 对 象 的 通 
用 能 力 ， 其 他 所 有 类 型 的 对 象 都 可 以 放 入 容器 之 内 ， 声 明 容 器 时 ， 用 具体 的 类 型 标明 容器 中 使 
用 的 类 型 即 可 ， 这 就 是 泛 型 的 基本 使 用 。 
1.7.1 泛 型 的 基本 使 用 

泛 型 的 基本 使 用 前 面 已 经 有 所 涉及 ， 在 下 面 的 例子 中 将 创建 一 个 继承 结构 ， 然 后 用 
来 声明 容器 ， 看 看 容器 是 否 表 现 正 常 。 并 且 创 建 一 个 泛 型 方法 ， 观 察 其 对 类 型 的 处 理 。 


class Fruit{ 
public void print() { 
System.out.println("Tt is a Fruit!"); 


T 
i 
x 
pas 
S 
z 


j 
j 


class Apple extends Fruit{ 
public void print() { 
System.out.println("Tt is an Apple!"); 
} 
} 


class Orange extends Fruit{ 
public void print() { 
System.out.println("It is an Orange!"); 
j 
} 


public class TempleteTypeErase { 
public static <T> void print(List<T> list) { 
for(T t:list) { 
if( t instanceof Apple) { 
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System.out.println("It is an Apple!"); 
}else if( t instanceof Orange ) { 

System.out.println("It is an Orange!"); 
}else if( t instanceof Fruit ) { 

System.out.println("It is an Fruit!"); 


} 
j 


public static void main(String[] args) { 
List<Fruit> fruits = new ArrayList<Fruit>(); 
fruits.add(new Fruit()); 
fruits.add(new AppleO); 
fruits.add(new Orange()); 
for(Fruit fruit : fruits) { 


fruit.print(); 
} 
print(fruits); 
} 
} 
运行 结果 如 下 
It is a Fruit! 
It is an Apple! 


It is an Orange! 
It is an Fruit! 

It is an Apple! 
It is an Orange! 


使 用 泛 型 的 容器 ， 很 好 地 保存 了 对 象 ， 并 且 取 出 对 象 后 仍 具 性 ， 可 见 泛 型 容器 的 使 
用 非常 简单 。 代 码 中 使 用 了 一 个 静态 方法 print， 这 个 方法 也 是 通过 泛 型 定义 的 ， 在 方法 内 不 知 
道具 体 的 数据 类 型 ?， 所 以 通过 动态 类 型 检查 来 确定 类 型 。 


1.7.2 ”通配符 
Fruit 是 Apple 类 的 基 类 ， 那 么 List<Frui 人 和 List<Apple> 之 间 是 什么 关系 呢 ? 看 看 下 面 的 例子 。 


public static void testExtendWildcard() { 
List<Apple> apples = new ArrayList>(); 
apples.add(new Apple()); 
//List<Fruit> fruits = apples; 
List<? extends Fruit> fruits2 = apples; 
//fruits2.add(new Apple()); 
fruits2.get(0).print(); 


} 


public static void testSuperWildcard() { 
List<Fruit> fruits = new ArrayList(); 
fruits.add(new Fruit()); 
List<? super Apple> apples = fruits; 


O 在 方法 内 部 类 型 被 探 除 了 ， 记 以 无 法 知道 T 到 底 是 什么 类 型 。 
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apples.add(new Apple()); 
((Fruit)apples.get(0)).print(); 


} 


通过 代码 发 现 ，List<Fruit> 和 List<Apple> 之 间 并 没有 关系 ， 尤 其 需要 注意 的 是 ， 不 要 以 为 
它们 是 继承 关系 。 如 果 想 用 另 一 个 容器 指 代 List<Apple>， 就 


extends Fruit> 来 指 代 List<Apple>。 此 用 法 大 多 作为 方法 
Fruit 子 类 的 容器 。 男 外 还 需 兴 


数据 。 原 区 
中 添加 了 适当 的 类 型 。 


对 象 就 会 出 现 错误 。 


List<? super Apple> 指 代 了 Fruit 至 Apple 及 派生 
因为 添加 的 对 象 类 型 更 加 明确 


1.7.3” 泛 型 接口 


Java 的 泛 型 


区 别 于 C+ 的 泛 型 实现 主要 在 类 型 擦 除 。 


到 了 通配符 ， 
的 参数 判断 ， 例 如 
E 意 ， 无 法 通过 List<? extends Fruit> 向 容器 中 
就 是 这 个 容器 指 代 了 一 切 继承 自 Fruit 的 类 的 容器 ， 所 以 无 法 确 负 


可 以 用 List<? 
某 方法 参数 需要 一 个 
添加 数据 ， 只 能 获取 
是 否 正 确 地 回 容 器 


tb KE 


N 


例如 当 ? Extend Fruit 指 代 一 个 Apple 容器 时 ， 如 果 


进行 静态 类 型 检查 ， 编 译 器 生成 的 代码 会 控 除 相应 


本 就 不 知道 泛 型 所 代表 的 具体 类 型 。 
为 它们 都 是 List<Object>。 但 是 也 不 是 毫 无 办 法 ， 
的 具体 类 型 必须 实现 此 接口 ， 这 样 还 能 保留 部 分 接 


的 类 型 信息 ， 这 


口 


ab 
He] o 


public interface PrintInterface<T> { 
public void print(); 


j 


以 上 是 声明 的 泛 型 接 


， 这 个 接口 希望 保留 打印 的 能 


Comparable<T>， 它 保留 了 对 象 比较 的 能 力 。 


1.74 自 定 义 泛 型 
声明 了 泛 型 接口 ， 


下 面 的 代码 将 演示 泛 型 接 


class Tomato implements PrintInterface<Tomato>{ 


@Override 


public void print() { 
System.out.println("It is Tomato!"); 


} 
} 


public class CustomTemplete<T extends PrintInterface<T>> { 
public T data; 


public void print() { 
data.print(); 


} 


public static void main(String[] args) { 
CustomTemplete<Tomato> customTemplete = new CustomTemplete>(); 
customTemplete.data = new Tomato(); 
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向 容器 中 添加 Orange 


E 类 继承 关系 链 的 对 象 ， 可 以 向 其 添加 对 象 ， 


， 可 以 通过 类 型 转换 成 基 类 Fruit 来 获取 和 使 有 


类 型 擦 除 就 是 说 Java 泛 型 只 在 编译 期 
È 
也 就 是 说 在 运行 期 间 无 法 识别 List<String> 和 List<Integer>, 
可 以 定义 一 个 泛 型 接口 ， 然 后 让 泛 型 


到 了 运行 期 间 实际 上 JVM 根 


HAR. 


EJ 


因 
明 传 进 


小 十 


RFA 


LSE ae iF AOZ Ye O 


F 


Fe 


在 泛 型 类 中 是 如 何 使 用 的 。 
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customTemplete.print(); 


} 
运行 结果 如 下 : 
It is Tomato! 
创建 了 一 个 继承 自 泛 型 接口 的 Tomato 类 ， 并 且 重 写 了 接口 方法 用 来 打印 数据 。 泛 型 类 
CustomTemplete 通过 <T extends PrintInterface<T>> 表 示 ， 传 入 的 类 型 必须 继承 此 泛 型 接口 。 所 以 
可 以 在 main 方法 中 调用 泛 型 类 的 打印 ， 如 果 不 继承 此 接口 ， 那 么 data 对 象 在 泛 型 内 部 并 不 知道 
自己 具备 什么 能 力 〈 仅 有 具备 Object 对 象 能 力 )。 
以 上 介绍 了 泛 型 的 常用 方法 和 一 些 与 其 他 语言 不 同 的 地 方 ， 同 时 还 在 Java 泛 型 擦 除 的 现实 
下 保留 了 部 分 接口 能 力 。 


1.8 异常 


对 于 使 用 Java 编写 的 程序 ， 编 译 器 在 编译 的 时 候 会 进行 语法 检查 等 工作 。 但 是 有 一 些 程序 
中 存在 的 问题 是 编译 阶段 无 法 识别 的 ， 例 如 用 Java 实现 了 一 个 计算 器 ， 当 用 户 输入 除数 为 0 的 
情况 下 ， 怎 么 办 ? 这 就 是 异常 处 理 存在 的 原因 。 这 些 错误 会 导致 程序 无 法 继续 进行 ， 而 异常 处 
里 就 是 处 理 这 些 错误 的 。 


Ne 


y= 


1.8.1 运行 时 异常 


运行 时 异常 是 程序 在 执行 过 程 中 出 现 错 误 的 调用 而 抛 出 的 异常 ， 这 种 异常 都 可 以 在 编写 时 
避免 ， 而 编译 器 也 不 要 求 对 可 能 抛 出 运行 时 异常 的 代码 段 强制 加 上 try 语句 。 下 面 看 几 种 常见 的 
运行 时 异常 。 

public class JavaRuntimeException { 


public static void testDivisor() { 
int i= 6/0; 


} 


public static void main(String[] args) { 
testDivisor(); 


Exception in thread "main" java.lang.ArithmeticException: / by zero 
at com.javadevmap.exception.JavaRuntimeException.testDivisorJavaRuntimeException.java:5) 
at com.javadevmap.exception.JavaRuntimeException.main(JavaRuntimeException.java:9) 
一 个 整数 除 以 0 在 算术 上 是 明显 错误 的 ， 但 是 这 个 问题 编译 器 目前 是 不 会 报错 的 ， 只 会 
在 执行 时 抛 出 一 个 异常 ， 异 常 包含 错误 的 类 型 和 代码 的 位 置 ， 可 以 很 容易 地 找到 出 问题 的 地 方 
并 且 优化 。 下 面 用 异常 捕获 来 处 理 这 段 代 码 。 
public static void testDivisor() { 


try { 
int i= 6/0; 
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System.out.println("i = " + i);° 
} catch (Exception e) { 
System.out.println("divisor can not be 0"); 


divisor can not be 0 


例子 中 用 try/catch 进行 了 代码 运行 和 异常 捕获 ，try 语句 块 的 意思 是 执行 代码 ，catch 语句 块 

的 意思 是 对 try 中 的 代码 异常 进行 处 理 。 当 然 这 里 只 作为 演示 ， 实 际 项 目 中 一 般 还 是 先 用 站 语句 
判断 除数 是 否 为 0， 为 0 则 直接 进行 提示 或 者 其 他 的 处 理 ， 而 不 用 异常 捕获 来 进行 处 理 ， 这 样 就 
避免 了 运行 时 异常。 
下 面 代码 演示 空 引用 异常 : 
public static void testNullPoint() { 


Person person = null; 
System.out.printIn(person.1d); 


Exception in thread "main" java.lang.NullPointerException 
at com.javadevmap.exception. JavaRuntimeException.testNullPoint(JavaRuntimeException java: 17) 
at com.javadevmap.exception.JavaRuntimeException.main(JavaRuntimeException.java:22) 


这 种 空 异 常 的 避免 办 法 一 般 也 是 在 调用 前 对 不 确定 是 否 已 经 初始 化 的 对 象 进 行 非 空 判 断 ， 
从 而 避免 这 种 异常 。 
下 面 代码 演示 常见 的 List ei o 
public static void testArrayRemove() { 

List<String> list = new ArrayList<>(); 
list.add("one"); 
list.add("two"); 
list.add("three"); 
int index = 0; 


for(String string : list) { 
System.out.println(string); 


index++; 

if(index==1) { 
list.remove(index); 

} 


Exception in thread "main" java.util.ConcurrentModificationException 
at java.util. ArrayList$Itr.checkF orComodification(Unknown Source) 
at java.util. Array List$Itr.next(Unknown Source) 


O 异常 发 生 后 ， 后 面 的 语句 不 会 执行 。 
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at com.javadevmap.exception.JavaRuntimeException.testArrayRemove(JavaRuntimeException.java:48) 
at com.javadevmap.exception.JavaRuntimeException.main(JavaRuntimeException.java:63) 
这 种 情况 ， 在 for 循环 遍历 过 程 中 移 除 List 元 素 是 非常 危险 的 ， 如 何 避 免 请 参看 1.6 节 。Java 的 
这 种 运行 时 异常 有 很 多 种 ， 例 如 数组 越界 异常 、 类 型 转换 异常 等 。 寞 常 的 处 理 不 是 背 出 来 的 ， 在 实 
际 的 代码 中 去 解决 异常 才 是 最 快 的 学 习 方 法 ， 本 书 附 带 的 代码 中 包含 了 其 他 异常 的 几 种 情况 ， 读 者 
可 以 尝试 模拟 、 处 理 和 避免 运行 时 异常 。 
1.8.2 检查 性 异常 
运行 时 异常 基本 都 可 以 避免 ,只 要 代码 足够 严谨 就 不 会 出 现 运行 时 异常 。 所 以 真正 的 代码 
中 要 处 理 的 是 检查 性 异常 。 这 就 涉及 异常 的 抛 出 和 捕获 ， 在 抛 出 异常 的 地 方 使 用 throw 关键 字 抛 
出 ;在 抛 出 异常 的 方法 后 面 添加 “throws 异常 类 名 ”。 异 常 捕获 的 地 方 使 用 try-catch-finally。 下 
面 看 一 个 读 取 文件 的 例子 。 
public static String readFile() { 


boolean bool = true; 
StringBuilder builder = new StringBuilder(); 


FileReader fReader = new FileReader("d:\\test.txt"); 
char[] cs = new char[10]; 
while (fReader.read(cs)!=—1) { 

builder.append(cs); 

cs = new char[10]; 


fReader.close(); 
} catch (Exception e) { 
bool = false; 
e.printStackTrace(); 
} finally { 
if(bool) { 
System.out.println("read file ok!"); 
yelse { 
System.out.println("read file fail!"); 
builder.replace(0, builder.length(), "fail"); 
} 
} 


return builder.toString(); 


} 


public static void main(String[] args) { 
System.out.printIn(readFile()); 


} 

运行 结果 如 下 : 
read file ok! 
1234567890 


23456789 
end 


在 这 个 例子 中 ， 使 用 文件 读 写 类 FileReader 读 取 一 个 文件 ， 在 创建 这 个 类 的 时 候 ， 编 译 器 
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强制 要 求 程序 员 必 须 把 这 个 方法 放 入 一 段 try 语句 中 ， 或 者 使 整个 方法 向 外 抛 出 异常 〈 添 加 
throws 语句 ) 由 外 层 进 行 处 理 ， 否 则 编译 不 通过 ; 这 是 区 别 于 运行 时 异常 的 地 方 ， 运 行 时 异常 
允许 编译 通过 。 

如 果 在 文件 的 路 径 下 没有 找到 对 应 的 文件 ， 则 会 抛 出 一 个 文件 不 存在 的 异常 ， 这 个 异常 会 
被 catch 捕获 ， 并 由 e.printStackTrace() 方 法 打印 到 控制 侣 。finally 语句 是 一 定 要 执行 的 ， 它 根据 
读 取 文件 过 程 中 判断 是 否 发 生 异 常 来 识别 文件 是 否 读 取 成 功 ， 如 果 发 生 异 常 则 会 把 返回 的 字符 
串 置 为 fail， 用 于 标明 失败 。 在 这 个 例子 中 连接 字符 串 使 用 了 StringBuilder 类 ， 如 果 读 者 感 兴趣 
可 以 研究 一 下 它 的 特性 。 


1.8.3” 自 定义 异常 


在 实际 编程 中 ， 例 如 数据 库 中 的 数据 出 现 了 业务 逻辑 上 的 错误 等 情况 ， 和 希望 通过 抛 出 一 个 
异常 把 问题 暴露 出 来 ， 而 已 有 的 异常 类 型 不 能 说 明 问 题 的 原意 ， 所 以 需要 自 定 义 一 个 异常 。 自 
定义 异常 非常 简单 ， 只 要 继承 相关 的 异常 类 就 可 以 了 。 代 码 如 下 。 

public class CustomRuntimeException extends RuntimeException { 


j 
public class CustomException extends Exception { 
} 
public class CustomExceptionDemo { 
public static void testRuntimeException () { 
throw new CustomRuntimeException(); 


ua 


} 


public static void testException() throws CustomException { 
throw new CustomException(); 


} 


public static void main(String[] args) { 
try { 
testException(); 
} catch (CustomException e) { 
System.out.println("catch CustomException"); 
} catch (Exception e) { 
System.out.println("catch Exception"); 


} 


} 
运行 结果 如 下 : 
catch CustomException 


在 上 面 的 例子 中 ， 自 定义 了 两 个 异常 ， 但 是 两 个 异常 的 继承 关系 不 一 样 。 一 个 继承 了 
RuntimeException， 男 一 个 继承 了 Exception， 这 两 种 继承 关系 会 导致 在 实际 使 用 中 存在 区 别 。 继 
承 自 RuntimeException 的 异常 ， 当 用 throw 抛 出 的 时 候 ， 包 含 它 的 方法 不 需要 用 throws 声明 要 
抛 出 异常 ， 继 承 自 Exception 的 异常 则 需要 在 方法 上 明确 声明 抛 出 异常 类 型 。 用 catch 异常 捕获 
时 ， 是 按照 顺序 从 第 一 个 匹配 的 异常 类 型 进行 捕获 的 ， 一 般 都 会 把 异常 的 基 类 Exception 放 到 顺 
序 的 最 后 ， 防 止 它 拦截 了 其 他 的 捕获 。 

异常 还 包含 其 他 一 些 方法 可 供 使 用 ， 但 是 对 于 简单 情况 ， 只 需要 继承 一 个 异常 ， 并 且 用 类 
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经 可 以 实现 在 程序 内 的 很 多 业务 处 理 能 力 了 ， 但 是 在 实际 的 
的 需求 ， 这 就 需要 对 IO 有 相应 的 了 解 。1/O 使 Java 程序 可 以 和 控 
务 、 数 据 库 、 绥 存 等 各 个 组 们 
人 多 系统， 否则 只 能 是 一 个 个 程序 计算 的 孤岛 。 
的 基本 IO 还 是 对 研发 者 的 工作 有 好 处 的 。 


， 有 了 VO 才能 把 程序 


进行 信 息 的 互通 
昌 然 很 多 组 件 都 封装 了 简单 易 用 的 


Java 的 IO 主要 包含 两 种 流 ， 分 别 是 字 节 流 和 字符 流 。 字 节 流 分 为 恋 入 〈InputStream) 和 输 


tH (OutputStream ) ; 


UnicodeS 字 符 处 到 
1.9.1 控制 台 IO 


ey 


符 流 分 为 读 入 〈Reader ) 和 输 H 
能 力 的 ， 如 果 不 需要 Unicode 基本 都 可 以 选择 字 节 流 。 


在 IDE 中 负责 控制 台 输 入 输出 的 就 是 Console 窗 
两 种 不 同 的 IO 流 分 别 读 取 此 数据 ， 观 察 两 种 不 同 IO A 


public static void testConsoleStreamIOO { 


try { 


} 
} 


char c; 
InputStream in = System.in; 


do { 


c = (char) in.read(); 
System.out.println(c); 


} while (c!='q‘); 
} catch (Exception e) { 
System.err.printin("catch Exception"); 


public static void testConsoleBufferlO() { 


try { 


j 
j 


第 一 种 方法 直接 获取 系统 的 字 节 输入 流 ， 读 取 流 数据 分 别 显 


© Unicode 是 为 了 


char c; 
BufferedReader in = new BufferedReader(new InputStreamReader(System.in));° 


do { 


c = (char) in.read(); 
System.out.println(c); 


} while (c!='q'); 
} catch (Exception e) { 
System.err.printin("catch Exception"); 


解决 


传统 的 字符 编码 方案 的 


满足 跨 语言 、 跨 平台 进行 文本 转换 、 处 理 的 要 求 。 


© Java5 之 后 , A 


[以 使 


Scanner 来 读 取 输 入 。 


>» 


下 面 通过 此 窗 


输入 数据 ， 然 后 通 ; 
的 读 取 结果 。 代 码 如 下 : 


H (Writer )。 两 者 选择 的 根据 是 针对 


过 


示 到 控 


; 第 二 种 方法 用 字 


RTIA 


E 的 ， 它 为 每 种 语言 了 


的 每 个 字符 设 定 了 统一 并 且 哈 


一 的 二 进 制 编码 ， 以 
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符 流 封装 了 系统 输入 流 ， 然 后 读 取 数 据 显示 至 控制 台 ， 使 用 这 两 种 方法 ， 当 读 取 全 英文 时 没有 
分 别 ， 当 读 取 汉字 时 ， 使 用 字符 流 的 方式 能 够 准确 输出 汉字 ， 而 字 节 流 则 不 能 。 这 就 是 字 节 流 
和 字符 流 最 明显 的 区 别 。 所 以 当 读 取 二 进 制 文件 时 ， 例 如 音频 、 图 片 等 使 用 字 节 流 是 合适 的 方 
式 ， 当 读 取 汉字 时 使 用 字符 流 是 合适 的 方式 。 


1.9.2 查看 文件 列表 


File 类 是 Java 对 文件 和 目录 进行 操作 的 类 ， 可 以 用 它 对 文件 进行 创建 、 改 名 、 删 除 等 操 
Ve. File 类 的 使 用 相对 简单 ， 而 且 对 应 的 API 也 很 健全 ， 只 要 正确 使 用 即 可 。 下 面 以 遍历 目录 
下 的 文件 列表 为 例 ， 简 单 介绍 File 类 的 使 用 。 代 码 如 下 
public class FileListDemo { 
public static List<String> getFileListByDir(File dir){ 
List<String> list = new ArrayList<>(); 
for(File item : dir.listFiles()) { 
if(item.isDirectory()) { 
list.addAIl(getFileListByDir(tem)); 


yelse { 
list.add(item.getName()); 
} 
} 
return list; 


public static List<String> getFileList(String uri) { 

List<String> list = new ArrayList<>(); 

File file = new File(uri); 

if(file.isDirectory()) { 
list.addAll(getFileListByDir(file)); 

yelse if(file.exists))&&file.isFile()) { 
list.add(uri); 

yelse if('file.exists()) { 
System.out.printin("file not found"); 

j 

return list; 


} 


public static void main(String[] args) { 
System.out.printIn(getFileList("D:\\projects\\JavaDeveloperMap\\JavaBasic\\sre")); 
} 


运行 结果 如 下 : 
[JavaBasicTypes.java, JavaOperatorjava, JavaProcessControl java, JavaArray.java, JavaList.java, 
JavaMap java, JavaSet.java, Animal.java, Fish.java, Tiger.java, CustomException.java, CustomException 


Demo java, CustomRuntimeException.java, FileExceptionDemo java, JavaRuntimeException.java, Console 
IO java, FileListDemo.java, Person.java, School.java, Student.java] 


main 方法 中 传 进 一 个 路 径 到 getFileList 777K, getFileList 方法 会 识别 这 个 路 径 是 文件 夹 还 是 
文件 ， 或 者 根本 不 存在 。 如 果 是 文件 夹 ， 则 进入 getFileListByDir 递归 方法 ， 搜 索 出 路 径 下 所 有 
文件 夹 下 的 文件 ， 加 入 到 List 中 ， 递 归 完 成 后 ， 得 到 一 个 文件 清单 。 
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1.9.3 文件 IO 


文件 的 读 取 在 1.8 节 已 经 涉及 ， 所 以 这 里 换 种 文件 的 读 取 方 法 来 演示 文件 的 读 写 。Java 的 
VO 类 比较 有 意思 的 地 方 是 你 可 以 通 过 流 之 间 的 包装 ， 在 最 外 层 类 对 象 中 使 用 较为 方便 的 功能 。 
public class FileIO { 
public static void write(String uri) { 
try { 


File file = new File(uri); 
FileOutputStream outputStream = new FileOutputStream(file); 
OutputStream Writer outputStream Writer = new OutputStreamWriter(outputStream,"UTF-8"); 
outputStreamWriter.write(" 你 好 ， 世 界 ! \nhello world!"); 
outputStream Writer.close(); 
outputStream.close(); 

} catch (Exception e) { 
e.printStackTrace(); 

j 

} 


public static String Read(String uri) { 
StringBuilder builder = new StringBuilder(); 
try { 
File file = new File(uri); 
FileInputStream inputStream = new FileInputStream(file); 
InputStreamReader inputStreamReader = 
new InputStreamReader(inputStream, "UTF-8"); 
while (inputStreamReader.ready()) { 
char[] c = new char[128]; 
inputStreamReader.read(c); 


builder.append(c); 

} 
inputStreamReader.close(); 
inputStream.close(); 

} catch (Exception e) { 
e.printStackTrace(); 

} 

return builder.toString(); 


} 


public static void main(String[] args) { 
write("d:\\test2.txt"); 
System.out.printIn(Read("d:\\test2.txt")); 


你 fo 世界 ! 
hello world! 
在 write 方法 中 ， 通 过 File 创建 了 FileOutputStream 流 ， 但 是 FileOutputStream 无 法 简单 
地 写 入 字符 串 ， 所 以 用 OutputStreamWriter 进行 了 包装 ， 这 样 就 可 以 把 String 类 型 号 入 文件 。 
在 Read 方法 中 ， 使 用 InputStreamReader 来 包装 FileInputStream， 从 而 实现 文件 内 容 的 读 取 。 
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1.9.4 序列 化 


当 把 一 个 Java 的 对 象 存 入 文件 或 者 进行 网 络 通信 时 ， 需 要 把 一 个 对 象 转 为 一 串 数据 ， 并 可 
以 再 反 转 回 一 个 对 象 ， 这 就 是 序列 化 的 需求 。Java 序列 化 有 几 种 方式 ， 例 如 对 象 的 类 继承 
Serializable 接口 ;或 者 对 象 的 类 继承 Externalizable 接口 ， 实 现 接口 的 两 个 方法 ; 或 者 转换 为 其 
他 的 通用 数据 交换 格式 ， 例 如 Json。 
(1) Serializable 方法 实现 序列 化 
采用 此 种 Java 序列 化 方式 较为 简单 ， 只 要 使 需要 序列 化 的 对 象 类 继承 此 接口 ， 并 且 保 证 对 
象 内 的 字段 也 是 可 序列 化 的 ， 如 果 存 在 不 可 序列 化 或 者 无 需 序列 化 的 字段 ， 可 以 用 transient X 
键 字 在 字段 前 标注 。 代 码 如 下 : 
public class JavaSerialize { 
static public class Address implements Serializable{ 
public double longitude; 
public double latitude; 
public String name; 
public transient Person person; 


} 


public static void write(String uri,Address address) { 
try { 
File file = new File(uri); 
FileOutputStream outputStream = new FileOutputStream(file); 
ObjectOutputStream objectOutputStream = 
new ObjectOutputStream(outputStream); 
objectOutputStream. writeObject(address); 
objectOutputStream.close(); 
outputStream.close(); 
} catch (Exception e) { 
e.printStackTrace(); 
} 
} 


public static Address Read(String uri) { 
Address address = null; 
try { 
File file = new File(uri); 
FileInputStream inputStream = new FileInputStream(file); 
ObjectInputStream objectInputStream = new ObjectInputStream(inputStream); 
address = (Address)objectInputStream.readObject(); 
objectInputStream.close(); 
inputStream.close(); 
} catch (Exception e) { 
e.printStackTrace(); 
} 
return address; 
} 


public static void main(String[] args) { 
Address address = new Address(); 
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address.latitude = 39.54; 

address.longitude = 116.23; 

address.name = "beijing"; 

address.person = new Person(7, "xiaoming"); 

write("d:\\test3.txt", address); 

Address result = Read("d:\\test3 txt"); 

System.out.println("address name = " + result.name +" longitude =" + result.longitude + " latitude = 
"+ result.latitude + " person =" + result.person); 


} 


} 
运行 结果 如 下 ; 

address name = beijing longitude = 116.23 latitude = 39.54 person = null 
在 此 例 中 ，Address 类 继承 了 Serializable 接口 ， 并 且 对 person 字段 标注 了 transient， 表 示 无 
需 序 列 化 。 创 建 Address 类 实例 后 ， 用 write 方法 把 序列 化 结果 存 入 一 个 文件 ， 然 后 用 read 方法 
从 文件 中 读 取 数据 并 且 反 序列 化 回 一 个 Address 实例 。 

(2) Externalizable 方法 实现 序列 化 

此 接口 包含 两 个 方法 ， 分 别 是 readExternal 和 writeExternal， 可 以 通过 这 两 个 方法 完成 序列 
化 的 定制 。 重 写 Adddress 类 ， 继 承 自 Externalizable 接口 。 代 人 码 如 下 : 


mh 


static public class Address implements Externalizable { 

public double longitude; 

public double latitude; 

public String name; 

public transient Person person; 

@Override 

public void readExternal(ObjectInput arg0) throws IOException, ClassNotFoundException { 
longitude = arg0.readDouble(); 
latitude = arg0.readDouble(); 
name = (String)arg0.readObject(); 

} 

@Override 

public void writeExternal(ObjectOutput arg0) throws IOException { 
arg0.writeDouble(longitude); 
arg0.writeDouble(latitude); 
arg0.writeObject(name); 


通过 重 写 此 Address， 最 后 达成 的 效果 和 上 一 个 例子 是 相同 的 ， 但 是 此 种 写法 给 了 编写 者 更 
大 的 灵活 度 ， 可 以 在 两 个 方法 中 修改 字段 数据 或 者 做 其 他 的 事情 。 在 实际 业务 中 具体 采用 哪 种 
方法 还 需要 根据 实际 需求 来 定 。 
(3) Json 
Json 是 一 种 轻 量 级 的 数据 交换 格式 ， 可 以 把 对 象 序列 化 为 Json 格式 ， 序 列 化 后 会 生成 一 个 
Json 格式 的 字符 串 。 上 例 中 的 数据 序列 化 后 变 为 : 
{ 


可 


"latitude": 39.54, 
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"longitude": 116.23, 
"name": "beijing", 
"person": { 

Wo eg 


ran "xiaoming" 


} 


这 种 格式 非常 简单 易 懂 ， 而 有 旦 方便 研发 人 员 直 接 阅 读 序列 化 后 的 数据 ， 具 体 如 何 转换 为 
Json 格式 会 在 后 续 章 节 讲 解 。 


1.9.5 网络 VO 


Java 服务 之 间 可 以 通过 网 络 进行 通信 ， 从 而 可 以 实现 程序 间 数 据 的 互通 ， 网 络 IO 是 Java 
服务 进行 微服 务 化 2 的 基础 。 网 络 通信 一 般 较 为 复杂 ， 但 本 书 所 涉及 的 内 容 一 般 不 用 考虑 过 多 的 
网 络 部 分 ， 网 络 问题 一 般 都 由 使 用 的 服务 框架 解决 。 所 以 这 里 仅 作为 演示 ， 了 解 Java 基本 的 通 
信 方 式 。 在 下 面 的 例子 中 ， 用 Socket 套 接 字 使 用 TCPs 协议 进行 通信 ， 创 建 两 个 Java 程序 ， 分 
别 是 客户 端 程序 和 服务 端 程 序 。 

(1) 服务 端 程序 

public class NetIOServer extends Thread { 
private ServerSocket serverSocket; 


= 


public NetIOServer(int port) throws Exception { 
serverSocket = new ServerSocket(port); 


//serverSocket.setSoTimeout(20000); 
} 


@Override 
public void run() { 
while (true) { 
try { 
Socket socket = serverSocket.accept(); 
socketDialogue(socket); 
} catch (Exception e) { 
e.printStackTrace(); 
break; 


j 


public void socketDialogue(Socket socket) { 
Thread thread = new Thread() { 
int count = 0; 
@Override 
public void run() { 
try { 


O 微服 务 化 其 实 主要 是 把 一 个 单一 的 服务 ， 通 过 能 力 的 区 别 进行 拆 分 ， 从 而 形成 一 个 个 模块 更 小 、 能 力 更 集中 的 服务 ， 服 务 之 间 
通过 网 络 进行 通信 ， 后 续 章 节 会 有 详细 介绍 。 


© TCP 是 网 络 七 层 协 议 中 的 面向 连接 的 、 可 靠 的 、 基 于 字 节 流 的 传输 层 通 信 协 议 。 
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while (socket.isConnected()) { 
DataInputStream inputStream = 
new DataInputStream(socket.getInputStream()); 


System.out.println("socket server receive: " + inputStream.readUTF()); 
Thread.sleep(5000); 


DataOutputStream outputStream = 
new DataOutputStream(socket.getOutputStream()); 
outputStream.writeUTF("server say nihao" + count++); 
j 
socket.close(); 
} catch (Exception e) { 
e.printStackTrace(); 
} 
j 
B 
thread.start(); 
} 


public static void main(String[] args) { 
try { 


NetIOServer server = new NetIOServer(18088); 
server.start(); 


} catch (Exception e) { 
e.printStackTrace(); 


} 
} 


在 这 段 代码 中 ， 提 前 使 用 了 线程 ， 线 程 的 使 用 在 1.10 节 中 讲解 。 在 main 方法 中 创建 了 一 个 
Server 监听 线程 ， 通 过 ServerSocket 监听 某 端 口号 ， 当 有 链接 请 求 时 通过 accept 方法 返回 和 客户 
端的 连接 。 通 过 Socket 得 到 客户 端 传 过 来 的 数据 ， 并 且 延 迟 5s 回复 客户 端 一 条 数据 。 这 个 逻辑 
是 写 在 无 限 循 环 中 的 ， 会 一 直 监 听 连 接 的 数据 情况 并 且 回 复 。 
(2) 客户 端 程序 
public class NetIOClient { 
public static void main(String[] args) { 
int count = 0; 
try { 


Socket socket = new Socket("127.0.0.1", 18088); 
DataOutputStream outputStream = 


a 


new DataOutputStream(socket.getOutputStream()); 
outputStream.writeUTF("client say nihao"); 


while (socket.isConnected()) { 
DatalnputStream inputStream = 


new DataInputStream(socket.getInputStream()); 


System.out.println("socket client receive: "+ inputStream.readUTF()); 
Thread.sleep(5000); 


outputStream.writeUTF("client say nihao" + count++); 

} 
socket.close(); 

} catch (Exception e) { 
e.printStackTrace(); 
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} 


客户 端的 逻辑 是 请 求 与 服务 端的 连接 ， 连 接 成 功 后 向 服务 端 发 送 一 条 数据 ， 发 送 完 第 一 条 
数据 后 ， 会 一 直 监 听 服 务 器 的 应 答 ， 并 且 延 迟 5s 回复 给 服务 端 。 所 以 在 这 个 例子 中 ， 客 户 端 和 
服务 端 之 间 会 一 直通 信 下 去 ， 直到 手动 结束 它们 。 它 们 的 输出 情况 为 : 
服务 端 输 出 : 

socket server receive: client say nihao 

socket server receive: client say nihao0 


socket server receive: client say nihaol 
socket server receive: client say nihao2 


客户 端 输出 : 


socket client receive: server Say nihao0 
socket client receive: server say nihaol 
socket client receive: server say nihao2 
socket client receive: server say nihao3 


以 上 仅 演示 了 基本 的 服务 间 通 信 ， 具 体 项 目 中 的 通信 情况 会 更 加 复杂 ， 好 在 使 用 框架 可 以 
解决 大 部 分 网 络 问 题 ， 让 研发 人 员 能 够 专心 完成 业务 逻辑 。 如 果 读 者 对 网 络 通 信 很 感 兴 趣 ， 可 
以 研究 网 络 通 信 的 NIO 框架 Netty， 相 信 会 有 不 少 收获 。 


1.10 并 发 


一 个 Java 程序 运行 在 一 个 进程 ?中 ， 但 是 如 上 面 例子 所 演示 ， 有 时 希望 一 个 程序 可 以 同时 
做 好 多 事情 ， 例 如 监听 端口 、 接 收 数 据 、 逻 辑 计算 等 等 ， 那么 只 有 一 个 运算 单元 就 明显 不 够 
了 ， 所 以 这 时 需要 启动 好 多 个 运算 单元 ， 这 就 是 多 线程 。 多 个 线程 的 执行 其 实 是 抢占 CPU 的 时 
间 ， 但 是 在 感觉 Ae 样 。 本 节 介 绍 多 线程 的 写法 和 一 些 重点 。 多 线程 其 实 是 一 
个 比较 困难 的 知识 点 ， 尤 其 对 于 初次 接触 的 新 人 来 讲 有 些 时 候 较 为 费解 ， 对 于 多 线程 的 学 习 一 
ee a E 真 正 理解 。 


1.10.1 多 线程 的 实现 
(1) Runnable 任务 


public class ThreadRunnable implements Runnable { 
private int start; 
private int end; 
public ThreadRunnable(int start,int end) { 


this.start = start; 
this.end = end; 
} 
@Override 


O 进程 是 程序 运行 的 实体 ， 计 算 机 系统 进行 资源 分 配 和 调度 的 基本 单位 。 
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public void run) { 
int sum = 0; 
for(int i = start;i<=end;i++) { 
sum+=1; 
} 
System.out.printIn("thread is " + Thread.currentThread().getName()+ " start =" + start + "end="+ 
end +" sum =" + sum); 


} 


public static void main(String[] args) { 
ThreadRunnable runnable = new ThreadRunnable(100,1000); 
runnable.run(); 


Thread thread = new Thread(new ThreadRunnable(200,2000)); 
thread.start(); 


} 

运行 结果 如 下 : 
thread is main start = 100 end = 1000 sum = 495550 
thread is Thread-0 start = 200 end = 2000 sum = 1981100 


ThreadRunnable 是 一 个 继承 自 Runnable 的 类 ， 如 果 在 主线 程 中 创建 这 个 类 ， 并 且 调 用 run 
方法 ， 其 实 它 并 没有 什么 特殊 ， 只 是 正常 执行 求 和 的 逻辑 。Runnable 对 多 线程 的 作用 就 是 可 以 
把 它 传 入 一 个 Thread 中 ， 作 为 新 建 线程 的 执行 任务 ， 这 样 就 实现 了 多 线程 。 

(2) 自 定义 Thread 

public class CustomThread extends Thread { 


@Override 
public void run() { 
try { 
Thread.sleep(1 000); 
} catch (Exception e) { 
e.printStackTrace(); 
} 
System.out.println(this); 
} 


public static void main(String[] args) { 
CustorThread thread] = new CustorThread(); 
thread 1.setPriority(Thread. MAX PRIORITY); 
CustorThread thread2 = new CustorThread(); 
thread1.setPriority(Thread.MIN_ PRIORITY); 
thread 1.start(); 
//thread2.setDaemon(true); 
thread2.start(); 


j 

运行 结果 如 下 : 
Thread[Thread-1,5,main] 
Thread[Thread-0, 1 ,main] 
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可 以 让 一 个 类 继承 自 Thread 类 ， 重 写 run 方法 来 实现 线程 的 任务 单元 ， 这 样 就 可 以 不 用 把 
王 务 单元 传 给 Thread， 只 要 创建 此 线程 并 且 调 用 start 即 可 实现 多 线程 。 在 这 个 例子 中 用 到 了 线 
星 的 几 个 方法 ，sleep 方法 用 来 使 线程 休 眼 ，setPriority 方法 用 来 设置 线程 的 优先 级 ，setDaemon 
方法 用 来 设置 后 台 线 程 ?。 

(3) 线程 池 

以 上 两 种 方法 都 需要 手动 创建 线程 、 启 动 线程 ， 如 果 使 用 线程 池 进 行 托管 ， 那 么 就 省 去 了 直接 
操作 线程 的 麻烦 ， 并 且 线 程 池 中 的 线程 还 可 以 复 用 ， 也 省 去 了 重复 创建 线程 的 开销 。 代 码 如 下 : 

public static void testCachedPool() { 
ExecutorService eService = Executors.newCachedThreadPool(); 


for(int 1=0;1<10;i++) { 
eService.execute(new ThreadRunnable(i*100,i*1000)); 


Loo 


aa 


} 


eService.shutdown(); 


} 


public static void testFixedPool() { 
ExecutorService eService = Executors.newFixedThreadPool(5); 
for(int 1=0;i<10;i++) { 
eService.execute(new ThreadRunnable(i*100,i*1000)); 
} 


eService.shutdown(); 


j 
以 上 是 两 种 创建 线程 池 的 写法 ， 只 要 把 任务 单元 传 入 线程 池 即 可 执行 多 线程 运算 ， 而 不 用 


F 动 创建 线程 。 这 两 种 方法 的 区 别 就 是 newFixedThreadPool 会 规定 最 大 线程 数 。 


1.10.2 ”线程 冲突 

F 面 的 几 个 例子 中 ， 都 会 为 每 个 线程 创建 独立 的 任务 单元 ， 目 前 看 来 执行 的 情况 恨 好 。 
设想 一 种 情况 ， 如 果 传 入 多 个 线程 中 的 任务 单元 是 相同 的 ， 并 且 使 用 了 同一 份 数据 ， 那 么 会 发 
生 什 么 ?代码 如 下 : 


public class ThreadConflict{ 
private int sum; 


U 


RÈ 


public int getSum(int start,int end) { 
sum = 0; 
for(int i=start;i<end;i++) { 
sum +=1; 
j 
return sum; 
j 
public static void main(String[] args) { 
ThreadConflict threadConflict = new ThreadConflict(); 
System.out.printIn("main thread sum = " + threadConflict.getSum(0, 1000)); 


ExecutorService eService = Executors.newCachedThreadPool(); 


O 当 一 个 程序 中 所 有 线程 都 为 后 台 线 程 ， 那 么 程序 会 退出 。 
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for(int i=0;1<10;i++) { 


eService.execute(new Runnable() { 


@Override 


public void run() { 
System.out.printIn(Thread.currentThread().getName() + " sum = " + threadConflict. 


getSum(0, 1000)); 


} 
D; 


eService.shutdown(); 


j 
运行 结果 如 下 : 


main thread sum = 499500 

pool-1-thread-1 sum = 499500 
pool-1-thread-2 sum = 499500 
pool-1-thread-3 sum = 499500 
pool-1-thread-1 sum = 499500 
pool-1-thread—4 sum = 499500 
pool-1-thread-2 sum = 499500 
pool-1-thread-6 sum = 499500 
pool-1-thread-7 sum = 499500 
pool-1-thread-5 sum = 327769 
pool-1-thread-8 sum = 743833 
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代码 中 创建 了 一 个 ThreadConflict 的 对 象 ， 这 个 对 象 包含 一 个 sum 字段 和 一 个 求 和 的 方法 。 
把 这 个 对 象 的 执行 任务 传 入 线程 池 进 行 计算 ， 结 果 有 的 线程 执行 结果 是 错误 的 。 


Java 


运 


算 ， 这 时 就 会 发 生 了 错误 ， 因 为 线程 A 抢占 


运算 到 


半 时 线程 B 抢占 了 线程 A F 


的 多 线程 执行 是 抢占 式 的 ， 当 多 个 线程 同时 抢占 同一 资源 进行 运 
重新 开始 计算 ， 线 程 B 计算 完毕 线程 A 抢占 回 资源 继续 运 


情况 下 ， 可 以 使 用 锁 解 决 并 发 导致 的 资源 抢占 问题 。 


1.10.3 


开 。 


Synchronized 关键 字 把 这 个 方 ; 


锁 


Synchronized 关键 字 


在 现实 世界 中 锁 住 某 些 东西 表示 独 
线程 同时 访问 的 单一 资源 ， 当 前 获得 执行 权限 的 线程 可 以 把 这 个 资源 锁 介 
下 面 介绍 几 种 简单 的 程序 加 锁 方 式 。 
(1) 
对 


占 或 者 使 用 中 ， 程 序 中 的 锁 也 是 同 检 


上 面 的 任务 单元 进行 修改 ， 改 为 如 下 内 容 ， 则 程序 运算 可 以 输 吕 


public synchronized int getSumBySyn(int start,int end) { 


sum = 0; 

for(int i=start;i<end;i++) { 
sum +=1; 

} 

return sum; 


} 


fe Bt 


RAID TT, “ABTA 


回 的 资源 数据 已 经 不 是 它 离 姑 


F 时 的 数据 了 。 在 这 种 


算 时 ， 有 可 能 线程 A 


的 意义 。 对 于 多 个 


EE， 执 行 完 毕 再 把 锁 打 


正确 区 


望 使 / 


] 此 方法 时 ， 此 关键 
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字 只 允许 一 个 线程 占用 此 方法 ， 其 他 线程 处 于 等 待 状态 ， 先 入 线程 执行 完毕 其 他 线程 再 分 别 单 
独 抢占 此 方法 。 
(2) Lock 
可 以 在 这 个 对 象 中 创建 一 个 ReentrantLock 的 实例 ， 对 需要 加 锁 的 代码 段 的 前 面 调用 lock 方 
法 上 锁 ， 执 行 完 毕 调 用 unlock 方法 解锁 。 这 样 也 可 以 避免 其 他 线程 抢占 此 公共 资源 。 此 实例 还 
包含 其 他 几 种 加 锁 的 方式 ， 例 如 使 用 tryLock 方法 。lock 方法 和 tryLock 方法 的 区 别 是 tryLock 
可 以 设置 立刻 返回 或 者 等 待 一 段 时 间 再 返回 。 
public class ThreadConflict{ 
private Lock lock = new ReentrantLock(); 


public int getSumByLock(int start,int end) { 


lock.lockQ); 
try { 
sum = 0; 
for(int i=start;i<end;i++) { 
sum +=1; 
} 
return sum; 
} finally { 
lock.unlock(); 
} 


} 
public int getSumByTryLock(int start,int end) { 


if(lock.tryLock(1, TimeUnit. SECONDS)) { 
sum = 0; 
for(int i=start;i<end;i++) { 
sum +=1; 
} 
} 
return sum; 
} catch (InterruptedException e) { 
e.printStackTrace(); 
return —1; 
} finally { 
lock.unlock(); 
} 
} 


常用 的 锁 还 有 读 写 锁 ReentrantReadWriteLock， 这 里 不 再 介绍 ， 和 希望 大 家 自己 完成 读 写 锁 的 
学 习 。 对 于 同步 代码 块 或 者 锁 的 使 用 一 定 要 精简 ， 在 确定 会 发 生 异 步 问 题 的 地 方才 加 入 同步 的 
还 辑 ， 和 否则 乱 上 锁 会 造成 很 大 的 性 能 问题 ， 多 线程 的 优势 也 得 不 到 发 挥 。 另 外 ， 被 锁 住 的 代 三 
也 要 精简 ， 不 要 把 见 余 的 可 以 异步 执行 的 代码 放 到 同步 代码 块 中 。 本 节 对 于 并 发 的 意义 以 及 并 
发 会 导致 的 问题 通过 几 个 例子 都 已 经 讲 到 了 ， 和 希望 读者 能 够 很 好 地 理解 并 且 使 用 多 线程 。 


1.11 反射 与 注解 
对 于 一 种 语言 来 讲 ， 前 面 的 内 容 好 像 够 全 面 了 。 那 么 Java 的 反射 和 注解 为 Java 做 出 了 什么 
54 


第 1 章 Java 概要 


页 献 呢 ? 

Java 的 反射 机 制 是 指 在 运行 状态 中 ， 对 于 任意 一 个 类 ， 都 能 够 知道 这 个 类 的 所 有 属性 和 方 
法 ， 对 于 任意 一 个 对 象 ， 都 能 够 调用 它 的 任意 方法 和 属性 。 这 种 动态 获取 信息 以 及 动态 调用 对 
象 方法 的 功能 称 为 Java 语言 的 反射 机 制 。 

Java 反射 机 制 的 意义 在 于 与 框架 结合 ， 各 个 框架 正 是 应 用 了 Java 的 反射 机 制 才 能 对 业务 代 
码 进行 加 载 和 整合 =。 那么 注解 的 意义 是 什么 ? 可 以 把 注解 理解 为 Java 对 类 、 字 段 或 方法 的 补充 
说 明 ，Java 通过 反射 读 到 注解 ， 通 过 注解 的 说 明 对 被 注解 内 容 进行 相应 的 操作 ， 例 如 生成 数据 
库 表 、 字 段 、 执 行 测试 等 。 


1.11.1 反射 


虽然 平时 使 用 反射 较 少 ， 但 是 理解 反射 却 非常 重要 ， 反 射 就 像 粘 合剂 一 样 ， 把 Java 框架 和 
程序 粘 合 在 一 起 ， 下 面 通 过 代码 了 解 反射 的 基本 能 力 。 
public class JavaReflect { 

public long num = 123456; 


—" 


public String name = "xiaoming"; 


TH 


@Override 
public String toString() { 


return "num=" + num +"/name="+ name; 


public void print() { 
System.out.println(toString(); 


public void set(long num,String name) { 
this.num = num; 


this.name = name; 


private void privatefun() { 
System.out.println("private fun"); 


} 


@Suppress Warnings({ "rawtypes", "unchecked" }) 
public static void main(String[] args) { 
try { 


Class reClass = JavaReflect.class; 
Class reClass2 = Class.forName("com.javadevmap.Reflect.JavaReflect"); 


if(reClass==reClass2) { 
System.out.println("class is single"); 


© 后 续 讲 到 Spring 时 相信 大 家 会 有 更 深 的 理解 。 
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Field[] fields = reClass.getFields(); 
System.out.println("fields : "+ Arrays.asList(fields)); 


Method[] methods = reClass.getMethods(); 
System.out.printin("methods : " + Arrays.asList(methods)); 


Constructor[] constructors = reClass.getConstructors(); 
System.out.println("constructors : "+ Arrays.asList(constructors)); 


Object reObject = reClass.newInstance(); 
Method method = reClass.getMethod("print"); 
method.invoke(reObject, null); 


method = reClass.getMethod("set" Jong.class,String.class); 
method.invoke(reObject, 234567,"daming"); 


method = reClass.getMethod("print"); 
method.invoke(reObject, null); 


method = reClass.getDeclaredMethod("privatefun"); 
method.setAccessible(true); 
method.invoke(reObject, null); 

} catch (Exception e) { 
e.printStackTrace(); 


} 


运行 结果 如 下 : 


public void 
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class is single 

fields : [public long com.javadevmap.Reflect JavaReflect.num, public java.lang.String 
com.javadevmap.Reflect.JavaReflect.name] 

methods : [public static void com.javadevmap.Reflect.JavaR eflect.main(java.lang.String[]), public 
java.lang.String com.javadevmap.Reflect.JavaReflect.toString(), public void com.javadevmap.ReflectJavaReflect. print(), 


com.javadevmap.Reflect.JavaReflect.set(long,java.lang.String), public final void java.lang.Object. wait() 
throws java.lang.InterruptedException, public final void java.lang.Object.wait(long, int) throws 
java.lang.InterruptedException, public final native void java.lang.Object.wait(long) throws 
java.lang.InterruptedException, public boolean java.lang.Object.equals(java.lang.Object), public native 
int java.lang.Object.hashCode(), public final native java.lang.Class java.lang.Object.getClass(), public 
final native void java.lang.Object.notify(), public final native void java.lang.Object.notifyAll()] 
constructors : [public com.javadevmap.Reflect. JavaReflect()] 

num=123456/name=xiaoming 

num=234567/name=daming 

private fun 


5 1 > 


第 1 章 Java 概要 


从 代码 中 可 以 看 出 ， 反 射 有 两 种 获取 Class 对 象 的 方式 ， 但 是 常 


种 方法 生成 的 Class 对 象 是 同一 个 ， 每 个 类 都 有 一 个 Clas 
字段 、 方 法 、 构 造 器 29。 并且 可 以 通过 反射 直接 获取 方法 ， 
至 可 以 调用 私有 方法 。 


s WE, 


j 的 还 是 第 二 种 方式 。 这 两 
并 且 唯 一 。 可 以 通过 反射 获取 
调用 带 参数 或 者 不 带 参 数 的 方法 ， 甚 


如 果 没 有 特殊 需求 ， 一 般 的 业务 逻辑 中 不 会 带 有 反射 ， 了 解 反射 的 用 处 和 能 力 就 好 ， 如 果 
有 更 高 的 要 求 ， 那 么 反射 还 是 要 仔细 研究 的 。 
1.11.2 注解 
注解 是 丰富 代码 信息 的 一 种 方法 ， 通 过 注解 可 以 更 加 了 解 代 码 ， 并 且 通 过 注解 解析 和 使 
用 ， 能 够 方便 管理 代码 和 让 编程 更 加 简单 。 
(1) Java 内 置 了 三 种 注解 ， 分 别 是 : 
E @Override: 表示 当前 方法 覆盖 基 类 的 方法 ， 如 果 基 类 不 存在 此 方法 ， 则 编译 器 会 报错 
《如 果 不 使 用 注解 ， 则 编译 器 不 会 检查 到 )。 
E @Deprecated: 表示 弃 用 的 方法 ， 如 果 其 他 类 使 用 了 这 个 注解 标注 的 方法 ， 编 译 器 会 生成 
警告 。 
E @SuppressWarnings: 关闭 警告 的 注解 ， 使 用 此 注解 后 编译 器 会 关闭 相应 类 型 的 警告 
(2) 元 注解 
注解 的 定义 是 基于 元 注解 的 ， 元 注解 可 以 理解 为 注解 的 注解 。 通 过 元 注解 来 修饰 自 定义 注 
解 ， 例 如 圈定 使 用 范围 或 应 用 阶段 等 ， 见 表 1-8。 
表 1-8 元 注解 
表示 注解 的 可 用 范围 ，ElementType 包含 以 下 几 种 ; 
@Target CONSTRUCTOR (构造 函数 ) ~ FIELD (字段 )、LOCAL VARIABLE (局 部 变量 ) 、METHOD (Ù 
法 ) 、PACKAGE ( 包 ) 、PARAMETER (参数 ) 、TYPE (类 、 接 口 、 枚 举 ) 
@Retention 表示 注解 的 应 用 级 别 ， 分 为 SOURCE, CLASS, RUNTIME (最 高 ) 
@Documented 可 以 被 Javadoc 文档 化 
@Inherited 注解 类 型 被 自动 继承 
(3) 自 定义 注解 
自 定义 注解 的 写法 和 接口 很 像 ， 只 是 在 名 字 前 面 加 上 @ 即 可 。 注 解 中 用 元 注解 修饰 自 定 义 
注解 的 应 用 范围 和 应 用 级 别 ; 注解 可 以 用 的 数据 类 型 包含 基本 类 型 、String、Class、enum、 


Annotation 以 及 这 些 类 型 的 数组 。 注 解 中 的 方法 不 能 有 参数 ， 但 
解 是 用 来 辅助 说 明 方法 是 做 什么 的 ， 


下 面 定 义 一 个 自 定 义 注 解 ， 这 个 尘 


接口 是 什么 。 
@Target(ElementType. METHOD) 
@Retention(RetentionPolicy.RUNTIME) 
@Inherited 
public @interface MethodUrl { 
public int IDO default -1; 


public String Describe(); 
public String URLO; 
} 
O 反射 调用 不 同 的 获取 方法 可 以 获取 不 同 可 见 类 型 的 字段 、 方 法 、 构 造 器 。 


是 可 以 有 默认 值 。 


以 及 它 对 外 暴露 的 
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自 定 义 注解 通过 @Target 设 定 ， 此 注解 用 于 方法 ， 通过 @Retention 设 定 注解 有 效 期 至 运行 
期 。 注 解 的 字段 包含 方法 的 描述 和 对 外 提供 的 URL 路 径 。 

(4) 注解 解析 

如 上 例 自 定 义 注 解 ， 这 个 注解 写 完 了 有 什么 用 呢 ? 用 于 给 方法 做 补充 说 明 ， 难 道 仅 仅 在 文 
档 上 有 用 吗 ? 下 面 给 一 个 类 加 上 自 定 义 注 解 ， 然 后 再 通过 一 个 解析 的 方法 把 注解 解析 出 来 ， 看 
看 它 的 用 处 有 多 大 。 

public class JavaAnnotation { 
public String name; 


@MethodUrl(ID=1 ,Describe="3 4 4", URL="/JavaAn/getName") 
public String getName() { 
return name; 


j 


@MethodUrl(ID=2,Describe=" 1%. 4", URL="/JavaAn/setName") 
public void setName(String name) { 
this.name = name; 
} 
} 


上 上 面 代码 建立 了 一 个 类 ， 这 个 类 有 两 个 方法 ， 对 每 个 方法 都 写 了 注解 ， 标 明了 这 个 方法 是 
做 什么 的 ， 以 及 一 个 路 径 。 下 面 的 代码 可 以 获取 JavaAnnotation 类 的 注解 情况 并 输出 。 
public static void main(String[] args) { 
try { 
Class clazz = Class.forName("com.javadevmap.Reflect.JavaAnnotation"); 
Method[] methods = clazz.getMethods(); 
for (Method method : methods) { 
MethodUrl methodUrl = method.getDeclaredAnnotation(MethodUrl.class); 
if(methodUrl!=null) { 
System.out.printIn(method.getName() + " function ID is " + methodUrl.IDQ +" and url is 
localhost:8080" + methodUrl.URLQ + " for " + methodUrl.Describe()); 


} 
} 
} catch (Exception e) { 
e.printStackTrace(); 


getName function ID is 1 and url is localhost:8080/JavaAn/getName for 获取 名 字 
setName function ID is 2 and url is localhost:8080/JavaAn/setName for 设置 名 字 
main 方法 通过 解析 ， 输 出 了 带 自 定义 注解 的 两 个 方法 的 名 字 ， 还 有 一 个 URL 地 址 ， 并 且说 
明了 用 途 。 某 些 Web 框架 其 实 就 是 用 这 种 方法 把 类 中 方法 和 访问 地 址 关联 起 来 ， 这 样 来 自 网 络 
的 调用 就 可 以 找到 对 应 的 方法 ， 从 而 实现 程序 对 外 提供 的 HTTP 服务 。 
注解 的 应 用 场景 很 多 ， 例 如 下 一 节 要 讲 的 JUnit 和 本 书后 面 的 很 多 框架 都 用 到 了 注解 的 内 
容 。 本 节 讲 的 是 基本 的 注解 使 用 原理 ， 了 解 原 理 之 后 对 以 后 章节 的 理解 会 更 加 轻松 。 
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1.12 JUnit 


当 编写 完 代码 ， 需 要 对 自 


己 写 的 功能 3 


行 测 试 时 ， 可 以 直接 写 一 个 main WH 


AE 


F 1# 


== 


Java 概要 


来 测试 自 


己 的 代 


码 ， 还 有 一 种 方式 测试 业务 代码 ， 即 本 节 介绍 的 JUnit HEN. JUnit 是 一 个 针对 Java 语言 的 单元 测 


试 框架 ， 通 过 使 用 JUnit 可 以 保证 程序 的 稳定 性 ， 并 且 减 少 花费 在 排 错 


1.12.1 JUnit 的 集成 


上 的 时 间 。 


JUnit 的 基础 环境 简单 来 说 就 是 下 载 对 应 的 JUnit 包 ， 解 压 到 本 机 ， 配 置 到 项 目的 Build Path 


中 。 下 面 介绍 两 种 集成 JUnit 的 方法 。 
C1) 如 果 当 前 项 目 为 非 Maven 管理 


E \https:/junit.org/junits/ Fa JUnit 最 新 版 本 的 压缩 文 但 


单 击 ->Build->Add Build Path” 即 可 。 


为 maven 管理 的 项 目 。 


(2) 当前 项 目 
在 项 目 
<! 一 junittest -> 
<dependency> 
<groupId>junit</groupId> 
<artifactld>junit</artifactld> 
<version>4. 12</version> 
<scope>test</scope> 
</dependency> 


添加 完 后 ， 在 项 目 
使 用 。 


1.12.2 JUnit 的 基本 使 用 


的 jar 包 放 到 Eclipse 项 目 里 面 的 libs” 文 件 来， 


的 pom.xml 文件 上 执行 “鼠标 右 


在 项 目 上 执行 “鼠标 右键 单 击 ->Build->Add Library”, E3% H 
击 next, WEP JUnit 的 版 本 ， 一 般 选 用 4.0 以 J 


的 pom 文件 中 的 dependencies 元 素 下 面 添加 如 下 代码 ; 


下 面 演示 JUnit 的 基本 使 用 。 编 写 一 个 业务 类 ， 上 


public class ServiceOfBusiness { 
private String serverCode; 
private boolean isTrueFlag; 
public ServiceOfBusiness() { 
super(); 
} 


// Constructor 


public ServiceOfBusiness(String code, boolean isTrue) { 


this.serverCode = code; 
this.is TrueFlag = isTrue; 
} 
// prints the Flag 
public boolean printFlag() { 


© libs 文件 夹 ， 此 文件 夹 通 常用 来 存放 第 三 方 依赖 。 如 果 当 前 项 


， 可 以 使 用 下 面 两 种 方式 集成 JUnit。 
F， 解 压 后 ， 将 需要 的 以 Junit 


然后 在 引入 的 jar E 


上 执行 “鼠标 右键 


来 的 界面 ， 


的 版 本 ， 点 击 Finish. 


BE 面 有 两 个 方法 如 下 : 


头 


选中 JUnit, 点 


键 单 击 ->Run as->Maven install” Bay 


没有 libs 文件 夹 ， 新 建 一 个 名 为 libs 的 目录 即 可 。 
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System.out.println(isTrueFlag); 
return isTrueFlag; 


} 
// prints the serverCode 


public String printServerCode() { 
System.out.printIn(serverCode); 
return serverCode; 


} 
对 上 面 的 两 个 业务 方法 进行 测试 。 编 写 一 个 JUnit 的 测试 类 步骤 如 下 : 
(1) 创建 一 个 名 为 TestJunit 的 测试 类 。 
(2) 向 测试 类 中 添加 名 为 testPrintMethods() 的 方法 。 
(3) 在 方法 上 添加 注解 @Test。 
(4) 执行 JUnit 的 assertEquals 方法 来 检查 测试 是 否 通过 。 
具体 代码 如 下 
public class TestJunit { 
String code = "Hello World"; 
ServiceOfBusiness service = new ServiceOfBusiness(code,false); 
@Test 
public void testPrintMethods() { 


assertEquals(code, service.printServerCode()); 
assertEquals(false, service.printFlag()); 


} 


在 testPrintMethods 上 执行 “鼠标 右 
JUnit 的 测试 结果 窗口 ， 如 图 1-2 所 示 。 


package com.javadevmap.junit; 


lL 


击 ->run as->Junit test”, 运行 完 后 ， 会 出 现 一 个 


import static org.junit.Assert.assertEquals; 
import org.junit.Test; 
public class TestJunit { 


String code = “Hello World"; 
ServiceOfBusiness service = new ServiceOfBusiness(code, false); 


@Test 

public void testPrintMethods() { 
assertEquals(code, service.printServerCode()); 
assertEquals(false, service.printFlag()); 


| n 


} 
J 
gu JUnit 2 = lm © Console X 局 Maven Repositories 
中 好 | Q H7 oy X 六 | eee 
Finished after 0.018 seconds 
& 
Runs: 1/ @ Errors: (@ Failures: ( <terminated> TestJunit.testPrintMethod 
Hello World 
d=] testPrintMethods [Runn = Failure Trace 六 false 


图 1-2 ”测试 结果 
其 中 的 状态 栏 显示 测试 用 例 通 过 和 未 通过 的 比例 ， 绿 色 表示 通过 ， 红 色 表 示 示 通过， 点 击 
F 边 的 未 通过 的 测试 方法 ， 还 可 以 看 到 未 通过 的 原因 信息 。 
测试 类 中 注解 的 含义 见 表 1-9。 
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表 1-9 JUnit 的 常用 注解 


注解 名 称 E X 

@Before 运行 前 调用 ， 一 般 用 于 初始 化 方法 
@Afier 运行 后 调用 ， 一 般 用 于 释放 资源 
@Test 测试 方法 ， 可 以 测试 方法 的 执行 情况 
@BeforeClass 所 有 用 例 运行 之 前 只 执行 一 次 ， 且 方法 必须 为 static void 
@AfterClass 所 有 用 例 运 行 之 后 只 执行 一 次 ， 且 方法 必须 为 static void 
@lgnore 忽略 的 测试 方法 

这 样 ， 使 用 JUnit 就 能 编写 一 个 测试 用 例 来 检验 自己 的 代码 。 
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Fete A =r 
2 


325 Maven 


在 Java 的 世界 中 ， 依 赖 管理 是 不 得 不 面 对 的 问题 。 无 论 是 外 部 的 开源 类 库 依 赖 ， 还 是 项 目 
内 部 的 模块 间 依 赖 ， 都 需要 进行 依赖 管理 。 可 以 说 依赖 管理 是 持续 集成 的 核心 内 容 之 一 。Maven 
抽象 定义 了 一 个 软件 的 完整 生命 周期 ， 遵 循 这 个 模型 ， 可 轻松 地 管理 自己 的 软件 项 目 ， 避 免 不 
必要 的 学 习 成 本 ， 并 促进 软件 项 目 管理 的 标准 化 、 流 程 化 。 


| 


上 


2.1 Maven 安装 和 配置 


从 本 节 开 始 实际 操作 Maven。 首 先 介 绍 如 何在 Windows 系统 中 安装 Maven 以 及 Maven 的 
基本 配置 。 


2.1.1 Maven 环境 的 搭建 
Maven 的 基础 环境 简单 来 说 就 是 下 载 对 应 的 Maven 包 ， 解 压 到 本 机 ， 配 置 对 应 的 环境 


d) 检查 IDK 环境 是 否 配置 成 功 ， 在 安装 Maven 之 前 ， 需 要 检查 当前 IDK 基础 环境 是 否 
配置 正确 ，Maven3.3+ 需 要 JDK 7 及 以 上 版 本 。 在 Windows 的 命令 行 输入 java -version， 运 行 命 
令 来 检查 IDK 的 版 本 ， 如 图 2-1 所 示 。 


Ise j 


图 2-1 Java 版 本 
(2) 首先 通过 官网 https:/maven.apache.org/download.cgi 下 载 对 应 的 Maven 版 本 ， 在 编写 本 


书 的 时 候 ，Maven 的 最 新 版 本 为 3.5.2， 这 里 下 载 apache-maven-3.5.2， 解 压 到 常用 软件 安装 目 
录 ， 然 后 进行 环境 变量 的 配置 。 在 计算 机 中 找到 设置 环境 变量 的 地 方 ， 添 加 对 应 的 变量 名 和 
值 ， 见 表 2-1 


R21 环境 变量 配置 


M2_HOME Capache-maven-3.3.2〈 请 配置 本 地 实际 路 径 ) 
Path %M2_HOME%)\bin; 


通过 以 上 两 步 就 配置 好 了 Maven 基础 环境 。 在 命令 行 输入 mvn -v， 观 察 输出 结果 ， 会 看 到 
Maven 的 路 径 等 信息 ， 表 明 Maven 已 正确 安装 ， 如 图 2-2 所 示 。 


0a5d7d，2017-10-18T1 


图 2-2 Maven 版 本 
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2.1.2 在 Eclipse 中 配置 Maven 的 settings 文件 


打开 Eclipse 工 


Maven 选项 的 “User 


settings.xml 文件 ， 


如 图 


检测 配置 


是 否 成 功 : H 


2-3 TAN. 


Settings”， 然 后 在 右边 的 全 


lL， 在 菜单 栏 选 择 “Window->Preferences”， 在 弹出 的 选项 卡 中 左边 选择 


Eclipse 


第 2 章 Maven 


局 配置 (Global Settings) 中 可 以 指定 自己 的 


的 “Window->Show View->Other”， 然 后 选择 “Maven-~> 


Maven Repositories”， 打 开 Maven 仓库 ， 会 出 现 Local Repositories 仓库 ， 在 此 仓库 下 可 以 看 到 在 


setting.xml 中 配置 


User Settings 


Global Settings (open file): 


过 的 仓库 ， 至 此 表示 Maven 配置 成 功 ， 如 


pa 


2-4 所 示 。 


n Repositories 33 


v E Local Repositories, 


Java EE Integratiol 


Lifecycle Mapping Update Settings 


Local Repository (From merged user and global settings): 


R Workspace Projects 


obal Repositories 
oject Repositories 


i Custom Repositories 


o x 
= N 局 Mave: 
Browse.. 
B Gl 
Browse... E pr 
Reindex 


图 2-3 Maven 设置 


2.2 Maven 使 用 


(EE 


输出 结果 。 


C\UsersAdministrator\ .m2\repository 


H 


Maven 基础 环境 准备 妥当 后 ， 创 建 


2.2.1 在 Eclipse 中 创建 第 一 个 Maven MH 


A — 


在 Eclipse 中 选择 “File->New->Maven Project”, 7E5'1H 


Ñ Local Repository (C\Users\Administrator\.m2\repository) 


图 2-4 Maven 仓库 


一 个 简单 的 Hello World 项 目 。 本 章 会 


步 地 编写 代 


LE 
Zy 


HEY tab 页 面 中 直接 点 击 Next 按钮 ， 


在 第 二 个 tab 页 面 中 保持 默认 的 Archetype? (maven-archetype-quickstart) 设置 即 可 ， 点 击 Next 


按钮 ， 在 第 三 个 tab 


=. 


页 面 


FP 输 入 信息 ， 见 表 2-2， 然 后 点 


表 2-2 项 目 配 置 


H Finish 按钮 即 可 。 


X 量 值 

Group Id com.javadevmap.demo 

Artifact Id Hello-world-demo 
Version 0.0.1-SNAPSHOT 


常见 的 Maven 项 目 代 码 
at 


Maven 项 目的 目录 


[ES 


Ez 


结构 如 图 
FE 一 般 如 下 。 


2-5 所 示 。 


E pom.xml: 用 于 Maven 的 配置 文件 。 
图 /src: 源 代码 目录 。 


E /src/main: 工程 源 代码 


Jz. 


E /src/main/java: 放置 项 目 Java 源 代码 目录 。 


© Archetype 是 Maven 提供 的 快速 构建 


5 


v Ù = hello-world-demo [JavaDeveloperMa 


@ src/main/java 
(® src/main/resources 


E} src/test/java 


E 


Z Maven Dependencies 
È src 
B target 


D pom.xml 


图 2-5 项 


à JRE System Library [jd 


63 


Java 服务 端 研 发 知识 图 谱 


图 /src/main/resources?: 放置 项 目的 资源 文 从 


m 
ig 


E /src/test: 单元 测试 目录 。 
图 /src/test/java: 工程 测试 Java 代码 目录 。 


E /target: 输出 目录 ， 项 目 输出 存放 在 此 目录 中 。 


2.2.2 ”认识 pom 文件 


Maven 项 目的 核心 是 pom.xml 文件 ， 此 文件 包含 项 目的 基本 信息 、 包 依赖 、 项 目 构 
息 。 下 面 为 常用 pom 文件 的 基本 内 容 。 
<?xml version="1.0" encoding="UTF-8"?> 

<project xmlns=http://maven.apache.org/POM/4.0.0 


xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd""> 


<model Version>4.0.0</model Version> 
<groupId>com.javadevmap.demo</groupId> 
<artifactld>hello-world-demo</artifactId> 
<version>0.0.1-SNAPSHOT</version> 
<packaging>jar</packaging> 
<name>hello—world-demo</name> 
<url>http://maven.apache.org</url> 
<properties> 
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding> 
</properties> 
<dependencies> 
<dependency> 
<groupld>junit</groupId> 
<artifactld>junit</artifactld> 
<version>3.8.1</version> 
<scope>test</scope> 
</dependency> 
</dependencies> 


</project> 


pom 命名 空间 以 及 xsd 元 素 。 
pom 文件 里 面 的 常见 元 素 以 及 含义 见 表 2-3。 


表 2-3 pom TREX 


建 


第 一 行 代码 是 XML 头 ， 然 后 是 project 元 素 ，project 是 pom.xml 的 根 元 素 ， 同 时 还 声明 了 


元 素 名 称 元 素 作 用 
<project> pom 的 xml 根 元 素 
<parent> 声明 继承 
<modules> 声明 聚合 
<groupId> 声明 项 目 属 于 哪个 组 织 
<artifactId> 声明 项 目的 唯一 人 D 
<version> 声明 项 目的 版 本 


© resources 目录 添加 方法 : 执行 “鼠标 右键 单 击 项 目 ->new->source folder->Folder name”， 填 写 /src/main/resources， 点 击 确定 ， 


生成 了 该 
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Ko 


第 2% Maven 


CE) 
元 素 名 称 元 素 作 

<packaging> 旧 定 当前 项 目 构建 类 型 ， 默 认 值 jar 
<build><plugins><plugin> 重 件 
<build><pluginManagement> 重 件 管理 
<repositories><repository> 仓库 
<pluginRepositories> 重 件 仓库 
<pluginRepository><dependencies><dependency> 依赖 
<dependencyManagement> 依赖 管理 

这 里 着 重 说 明 一 下 groupId、artifactId、version 这 三 个 标签 ， 它 们 定义 了 一 个 项 目的 基本 从 

tro FEAR] jar, pom 或 war 都 是 基于 这 三 个 标签 进行 区 分 的 。 
groupld 定义 了 项 目 属于 哪个 组 ， 建 议 用 公司 名 或 组 织 一 般 来 说 ，groupId 由 三 个 部 分 


组 成 ， 每 个 部 分 之 间 以 “.” 分 隔 


性 组 织 的 就 是 org; 第 二 
artifactId 定义 了 当前 Maven 项 


一 部 分 是 
部 分 是 公 


world-demo. 


version 指 项 目 当 前 的 版 本 ， 


全 
, 第 部 分 是 项 


司 名 ， 


y 


WJU tengxun, baidu, alibaba; 第 三 部 分 是 项 


用 途 ， 例如 用 于 商业 的 就 是 com， 用 于 非 营利 
日 名 。 


tA AL! 


唯一 的 ID, 14 


定义 此 项 目的 artifactld 为 hello- 


默认 版 本 为 SNAPSHOT 版 本 ，SNAPSHOT 意思 为 快照 ， 说 明 


当前 项 目 处 于 开发 迭代 中 ， 不 是 稳定 版 本 。 随 着 开发 的 推进 ， 可 以 对 版 本 依次 递 进修 改 ， 例 如 
xx.SNAPSHOT, xx.beta, 1.0, 2.0 等 。 
以 上 为 Maven 的 常用 标签 ， 下 面 简 要 介绍 Maven 的 其 他 标签 ， 见 表 2-4， 读 者 了 解 即 可 。 
表 2-4 pom 元 素 含 义 
元 素 名 称 元 素 作 

<properties> Maven 属性 

<reporting><plugins> 报告 插件 

<name> 名 称 

<description> DN 

<organization> 所 属 组 织 

<licenses><license> 许可 证 

<mailingLists><mailingList> p 件 列表 

<developers><developer> 发 者 

<contributors><contributor> 贡献 者 

<issueManagement> 问题 追踪 系统 

<ciManagement> 持续 集成 系统 

<scm> 版 本 控制 系统 

<prerequisites><maven> BERK Maven 最 低 版 本 ， 默 认 值 为 2.0 

<build><sourceDirectory> 主 源码 目录 

<build><scriptSourceDirectory> 靶 本 源码 目录 

<build><testSourceDirectory> 测试 源码 目录 

<build><outputDirectory> 主 源码 输出 目录 

<build><testOutputDirectory> 测试 源码 输出 目录 

<build><resources><resource> 主 资源 目录 

<build><testResources><testResource> 测试 资源 目录 


65 


Java 服务 端 研 发 知识 图 谱 


( 续 ) 
元 素 名 称 元 素 作 
<build><finalName> 输出 主 构件 的 名 称 
<build><directory> 输出 目录 
<build><filters><filter> 通过 properties 文件 定义 资源 过 滤 属 性 
<build><extensions><extension> 扩展 Maven 的 核心 
<profiles><profile> POMProfile 
<distributionManagement><repository> 发 布 版 本 部 署 仓 库 
<distributionManagement><snapshotRepository> 快照 版 本 部 署 仓 库 
<distributionManagement><site> 站 点 部 署 


2.2.3 ”运行 Maven MH 


当 编 号 好 业务 代码 后 ， 需 要 构建 运行 项 目 。 直 
As”, 就 能 看 到 常用 的 Maven 命令 ， 如 图 2-6 所 示 。 


B New bean definition... 


Show in Remote Systems view 


Validate | 
Run As > m2 1 Maven build 

Debug As N > m2 2 Maven build... 

Profile As > m2 3 Maven clean 

Maven > m2 4 Maven generate-sources 
Team > m2 5 Maven install 

Compare With > m2 6 Maven test 

Replace With > 


Run Configurations... 


图 2-6 运行 项 


接 在 项 目的 pom.xml 文件 上 右 击 ， 选 择 “Run 


Alt+Shift+X, M 


选择 要 执行 的 Maven 命令 就 能 执行 相关 的 构建 操作 ， 同 时 在 Eclipse 的 Console 中 就 KETI 


ae 
S, 只 需要 点 


执行 命令 的 结果 输出 。 如 果 想 执行 自 定义 顺序 的 命令 


击 “Maven build .. 


， 在 弹出 的 


H 


Wry, Un 


对 话 框 的 Goals 输入 中 输入 要 执行 的 命令 如 clean install E 


Z] 


2-7 所 示 。 


Edit Configuration 


Edit configuration and launch. 


x 


© 


Name: |hello-world-demo (1) 


[E] Main 


Base directory: 


BA JRE Refresh| 5> Source | I Environment| [=] Common 


S{project lochello-world-demo} 


Workspace... File System... | Variables... 
Goals: | clean install 
Profiles: 
User settings: | C:\Users\Administrator\.m2\settings.xml 
Workspace... File System... Variables... 
Offline Update Snapshots 
Debug Output Skip Tests Non-recursive 
Resolve Workspace artifacts 
1 ~ Threads 
Parameter Name Value Add... 
v 
Revert Apply 


Es 


图 2-7 构建 配 
KR 的 运行 结果 。 


TH Run 按钮 ， 可 看 到 如 图 2-8 所 示 


第 2% Maven 


INFO. 


INFO] --- maven-jar-plugin:2.4:jar (default-jar) @ hello-world-demo --- 

INFO] Building jar: D:\WorkSpace\hello-world-demo\target\hello-world-demo-@.@.1-SNAPSHOT. jar 
INFO 

INFO] --- maven-install-plugin:2.4:install (default-install) @ hello-world-demo --- 


INFO] Installing D:\WorkSpace\hello-world-demo\target\hello-world-demo-@.@.1-SNAPSHOT.jar to C:\Us 
INFO] Installing D:\WorkSpace\hello-world-demo\pom.xml to C:\Users\Administrator\.m2\repository\cc 
INFO) ----=-------------- es cee See ew eR R SE RESTS RAE SNS 

INFO] BUILD SUCCESS 

INFO] ------------------------------------------------------------------------ 

INFO] Total time: 46.765 s 

INFO] Finished at: 2018-@3-@3712:23:58+08:00 

INFO] Final Memory: 18M/151M 

INFO] ------------------------------------------------------------------------ 


图 2-8 ”运行 结果 
Goals 输入 框 常用 的 Maven 命令 见 表 2-5. 


32-5 Maven 命令 


Maven 常用 命令 命令 作 
mvn clean 清理 (删除 target 目录 下 的 编译 内 容 ) 
mvn compile 编译 项 
myn test 编译 并 执行 测试 用 例 
mvn package 打包 发 布 
mvn package -Dmaven.test.skip=ture 打包 时 跳 过 测试 
mvn install:install-file -DgroupId=<groupId> -DartifactId=<artifactId> 
—Dversion=1.0.0 安装 指定 版 本 到 本 地 仓库 
-Dpackaging=jar -Dfile=<myfile.jar> 


常用 命令 的 含义 如 下 : 

E compile: 编译 当前 项 目 ， 编 译 后 的 class 文件 会 放 在 项 目的 target/classes 文件 夹 中 ， 这 是 
Maven 约定 的 存放 位 置 。 

图 test: 编译 当前 项 目 并 执行 测试 用 例 ， 这 里 Maven 可 能 会 下 载 测试 所 依赖 的 构 伯 
在 测试 之 前 ，Maven 会 编译 主 代码 。 

E package: 打包 当前 项 目 ， 如 果 读 者 的 pom 文件 里 面 的 packaging 元 素 设置 的 值 为 jar， 那 
么 执行 此 命令 会 编译 当前 项 目 生成 一 个 jar 文件 存放 在 target 目录 下 面 ， 默 认 生 成 的 文件 
名 称 由 artifactId 和 version 拼接 组 成 。 

E install: 安装 到 仓库 命令 ， 可 以 把 生成 的 jar 文件 直接 安装 到 本 地 的 Maven 仓库 (默认 仓 

库 地 址 在 当前 用 户 目 录 下 面 的 .m2/repository 文件 夹 )。 


$ 
p 


2.3 Maven 坐标 和 依赖 


Maven 的 一 个 重要 功能 是 管理 项 目的 依赖 。 本 节 讲 解 Maven 坐标 和 它 的 作用 、Maven 如 何 
在 实际 的 项 目 中 进行 应 用 以 及 常用 的 Maven 使 用 技巧 和 实战 经 验 。 


2.3.1 ”什么 是 坐标 


坐标 是 Maven 中 任何 一 个 依赖 包 的 唯一 标识 。 任 何 一 个 构件 都 明确 地 定义 了 自己 的 坐标 。 
Maven 的 坐标 包含 以 下 几 个 元 素 ; 

E groupId 定义 了 当前 Maven 项 目的 归属 组 织 。 

E artifactld 定义 了 一 个 Maven 项 目 或 者 模块 的 唯一 名 称 。 

E version 定义 了 当前 Maven 项 目 所 处 的 版 本 。 

E packaging 定义 了 当前 Maven 项 目的 打包 方式 。 
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E classifier 定义 了 用 来 帮助 定义 构建 输出 的 一 些 附 属 构建 。 

ER 5 470384, groupld, artifactld, version 必须 定义 ，packaging T CRUX jar), 
classifier 是 不 能 直接 定义 的 ， 因 为 附属 构件 不 是 项 目 直接 默认 生成 的 ， 而 是 由 附加 的 插件 帮助 生 

Maven 会 根据 pom 文件 里 面 配置 的 坐标 元 素 ， 到 Maven 内 置 的 中 央 仓 库 (https://repol. 
maven.org/maven2/) 里 面 寻 找 对 应 的 依赖 包 ， 例如 在 pom 文件 中 定义 了 groupld=junit 、 
artifactId=junit, version=4.12, Maven 就 会 检查 本 地 仓库 有 没有 对 应 文件 ， 如 果 没 有 就 会 从 中 央 
仓库 找到 对 应 的 文件 并 下 载 到 本 地 的 仓库 ， 提 供给 工程 使 用 。 


2.3.2 ”什么 是 Maven 依赖 
在 项 目 开 发 的 时 候 ， 或 多 或 少 会 


此 标签 可 以 包含 一 个 或 多 个 dependency 元 素 ， 来 声明 当前 项 目 所 


如 下 形式 : 
<project > 


<dependencies> 
<dependency> 
<groupld>junit</groupId> 
<artifactId>junit</artifactId> 
<version>4.12</version> 
<scope>test</scope> 
</dependency> 
</dependencies> 


</project> 


每 个 依赖 的 groupId、artifactId、version 这 三 个 元 素 构 成 一 个 依赖 的 基本 坐标 ， 


下 面 讲解 在 Maven 项 目 中 如 何 引入 本 地 的 包 ， 例 如 在 其 他 项 目 


这 个 坐标 才能 找到 对 应 的 依赖 。 
现 有 的 项 目 中 来 。 

方法 一 : 
并 日 


<dependency> 


依赖 第 三 方 组 件 或 者 其 他 工程 模块 ，Maven 依赖 即 指引 用 
的 第 三 方 组 件 或 者 模块 。 这 体现 在 本 工程 的 pom 文件 里 面 project 


下 面 的 dependencies 标签 下 ， 


将 待 引入 的 包 放 在 指定 目录 下 《〈 如 lb 目录 下 )， 修 改 : 
将 scope HOY system. pom 文件 配置 如 下 所 示 : 


<groupId>com.javadevmap.demo</groupId> 
<artifactld>hello—world-demo</artifactId> 
<version>0.0.1-SNAPSHOT</version> 


<scope>system</scope> 


ROR AS ERS MEHL. ZA 


Maven 根据 


中 生成 一 个 jar 包 ， 引 入 到 


项 目的 pom 文件 ， 


加 入 依赖 


<systemPath>$ {project.basedir} /lib/hello-world-demo-0.0. 1 jar</systemPath> 


</dependency> 


方法 二 : 将 待 引入 的 jar 包 安 装 到 本 地 repository 中 ， 例 如 将 hello-world-demo-0.0.1 jar 安 


装 到 本 地 仓库 。 


D 先 把 待 引入 的 jar 包 放 在 一 个 目录 下 ， 打 开 命 令 行 


LAU F: 


install 命令 ， 
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FE -> 
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mvn install:install-file 
—Dfile=hello—world-demo-0.0.1 jar 
—DgroupId=com.javadevmap.demo 
—DartifactId= hello-world-demo 
—Dversion=0.0.1-SNAPSHOT 
—Dpackaging=jar 


2) 在 项 目的 pom 文件 中 加 入 包 对 应 的 依赖 : 


<dependency> 
<groupId>com.javadevmap.demo</groupId> 
<artifactId>hello-world-demo</artifactId> 
<version>0.0.1-SNAPSHOT</version> 
</dependency> 


这 样 就 可 以 将 本 地 的 jar 文件 配置 到 自己 的 Maven 项 目 中 进行 使 用 了 。 
2.3.3 Maven 依赖 的 scope 范围 


Maven 在 不 同 的 生命 周期 使 用 的 classpath 是 不 同 的 ， 例 如 执行 项 目的 测试 和 Maven 项 目 运 
行 的 时 候 ， 这 两 者 之 间 的 classpath 是 有 差异 的 。 常 用 的 JUnit 构件 就 是 如 此 ， 在 测试 阶段 会 引 
入 ， 但 在 运行 Maven 项 目的 时 候 是 不 需要 的 。 

Maven 的 依赖 范围 与 classpath 的 关系 见 表 2-6。 


表 2-6 scope 范围 

scope 编译 期 测试 期 运行 期 说 J 
compile Y Y Y 编译 依赖 范围 ，scope 默认 使 用 compile 
全 只 在 测试 期 依赖 ， 如 JUnit 包 


cu 


test res 


provided Y 


Y 

Y = 运行 期 由 容器 提供 ， 如 servlet-api 4 
ninie 一 Y Y 编译 期 间 不 需要 直接 引 

Y 5 编译 和 测试 时 由 本 机 环境 提供 


system Y 


根据 上 面 的 信息 ， 可 以 轻松 地 引入 其 他 构件 ， 协 助 开发 程序 。 在 引用 其 他 依赖 时 如 果 出 现 
引用 冲突 ， 可 以 通过 Maven 的 传递 性 依赖 解决 这 一 问题 。 

如 果 依 赖 没有 声明 依赖 范围 ， 那 么 其 依赖 范围 就 是 默认 的 compile. (UI A 依赖 B，B 依赖 
C, WWA A X B 是 第 一 直接 依赖 ，B 对 C 是 第 二 直接 依赖 ，A 对 C 是 传递 性 依赖 。 第 一 直接 依 
赖 范围 和 第 二 直接 依赖 范围 决定 了 传递 性 依赖 的 范围 。 
在 表 2-7 中 ， 左 边 第 一 列表 示 第 一 直接 依赖 范围 ， 最 上 面 一 行 表示 第 二 直接 依赖 的 范围 
中 间 的 单元 格 表 示 传 递 性 依赖 范围 ， 表 格 中 的 “-” 表 示 依 赖 无 法 传递 。 


表 2-7 依赖 传递 


第 一 直接 依赖 \、 第 二 直接 依赖 compile test provided runtime 
compile compile = = runtime 
test test = = test 
provided provided provided provided 
runtime runtime 一 = runtime 
根据 上 面 的 规则 举例 ， 例 如 项 目 Proj 中 ， 有 一 个 直接 依赖 A， 其 依赖 范围 为 compile, M A 


依赖 里 面 又 有 一 个 B 的 直接 依赖 ， 其 依赖 范围 为 runtime， 那 么 显然 B 是 Proj 项 目的 传递 性 依 
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i, BHR 2-7， 第 一 直接 依赖 为 compile， 第 二 直接 依赖 为 runtime， 因 此 B 对 项 目 Proj 是 一 个 
范围 为 runtime 的 传递 性 依赖 。 


2.3.4 Maven 的 依赖 调解 原则 


当 项 目 里 面 依赖 变 多 的 时 候 ， 多 个 项 目 之 间 难 免 存 在 引用 不 同 版 本 依赖 的 情况 ， 这 样 容 易 
出 现 依赖 版 本 不 一 致 ， 导 致 项 目的 构建 出 现 问题 。 要 解决 此 问题 需要 明白 Maven 的 依赖 调解 原 
则 。 下 面 介绍 这 两 个 原则 。 

(1) 路 径 最 短 者 优先 。 

这 里 “->” 符 号 代表 依赖 , “0” 代 表 版 本 号 。 例 如 A->B(2.0) 指 的 是 A 依赖 版 本 号 为 2.0 的 
B 构件 。 下 面 是 两 条 依赖 链条 。 

A->B->C->X(1.0) 

A->D->X(2.0) 

可 以 发 现 两 个 依赖 链条 上 都 有 版 本 X, MH X 的 版 本 是 不 一 致 的 ， 根 据 路 径 最 短 者 优先 原 
则 ，X(.0) 的 版 本 路 径 长 度 为 3， 而 X(2.0) 的 版 本 路 径 长 度 为 2， 那 么 XX(2.0) 会 被 依赖 使 用 。 

(2) 依赖 路 径 长 度 相等 的 前 提 下 ， 顺 序 最 靠 前 的 那个 依赖 优先 。 

A->B->X(1.0) 

A->D->X(2.0) 

上 面 两 个 不 同 版 本 的 X 的 路 径 长 度 是 一 样 的 ， 依 据 Maven 定义 的 依赖 调解 的 第 三 原则 ;第 
一 声明 者 优先 。 这 里 X(1.0) 声 明 在 前 面 ， 会 被 工程 使 用 。 


2.3.5 Maven 仓库 使 用 


Maven 通过 仓库 来 管理 构件 ， 仓 库 分 为 两 种 类 型 ， 本 地 仓库 和 远程 仓库 。 当 Maven 根据 坐 
标 碍 找 构 件 的 时 候 ， 它 首先 会 查看 本 地 仓库 ， 如 果 本 地 仓库 存在 此 构件 ， 直 接 使 用 。 如 果 不 存 
在 ，Maven 就 会 去 远程 仓库 查找 ， 发 现 需 要 的 构件 后 ， 下 载 到 本 地 仓库 再 使 用 。 如 果 在 本 地 和 
远程 仓库 都 没有 找到 ， 那 么 Maven 就 会 显示 找 不 到 构件 的 错误 提示 信息 。 

本 地 仓库 是 在 用 户 当前 操作 系统 上 存放 构件 的 地 方 ， 默 认 在 当前 用 户 目录 下 面 都 有 一 个 路 
径 名 称 为 .m2/repository/ 的 仓库 目录 。 

中 央 仓 库 是 Maven 核心 自 带 的 远程 仓库 ， 包 含 了 大 部 分 开源 的 构件 。 在 默认 配置 下 ， 当 本 
地 仓库 没有 Maven 需要 的 构件 时 ， 它 会 尝试 从 中 央 仓 库 进 行 查找 下 载 。 

私服 是 另 一 种 远程 仓库 ， 例 如 许多 公司 为 了 节省 带宽 和 时 间 ， 会 在 内 部 搭建 一 个 私服 ， 也 
就 是 内 部 使 用 的 Maven 仓库 ， 可 以 存放 公司 内 部 的 构件 或 者 其 他 开源 构件 。 例 如 常见 的 Nexus 
服务 。 

众所周知 ， 国 内 开发 很 头疼 的 一 件 事 就 是 Maven 仓库 的 下 载 速度 太 慢 。 所 以 一 般 使 用 国内 
公开 仓库 ， 常 见 的 有 阿里 云 仓库 (http://maven.aliyun.com/nexus/content/groups/public/)。 

下 面 介 绍 如何 修 改 仓库 地 址 。 修 改 Maven 根 目 录 下 的 conf 文件 夹 中 的 setting.xml 文件 ， 对 
应 内 容 如 下 : 

<mirrors> 
a id> 
<name>aliyun maven</name> 
<url> 
http://maven.aliyun.com/nexus/content/groups/public/ 
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<ul> 
<mirrorOf>central</mirrorOf> 
</mirror> 
</mirrors> 


这 样 就 把 Maven 的 中 央 仓 库 的 地 址 修改 成 阿里 云 仓 库 地 址 了 。 
当然 也 可 以 定义 本 地 仓库 的 目录 地 址 ， 修 改 settings.xml 文件 ， 设 置 本 地 仓库 的 实际 存储 路 
径 。 例 如 : 
<settings> 
<localRepository>E:\Repository</localRepository> 
</settings> 


2.4 Maven 生命 周期 和 插件 


Maven 的 生命 周期 是 对 项 目 构建 生命 周期 的 一 个 抽象 。 在 Maven 出 现 之 前 ， 项 目 构 建 的 生 
命 周期 早已 存在 。 例 如 开发 人 员 对 项 目的 清理 、 编 译 、 测 试 以 及 部 署 。 


2.4.1 Maven 生命 周期 


Maven 有 一 套 完 善 、 易 扩展 的 生命 周期 。 包 含 了 项 目的 清理 、 初 始 化 、 编 译 、 打 包 、 集 成 
测试 、 验 证 、 部 署 和 站 点 生成 等 。 可 以 映射 到 目前 几乎 所 有 软件 的 生命 周期 上 。 

每 个 生命 周期 包含 了 一 系列 阶段 (phase)， 这 些 阶段 有 自己 的 顺序 ， 并 且 前 后 阶段 是 有 依赖 
关系 的 。Maven 的 生命 周期 如 图 2-9 所 示 。 


Maven 生 命 周 


a 
可 


Site-deploy 


从 左 向 右 依次 执行 


从 左 向 右 依次 执行 


| 
[ea oe I) CJC] Ge] 
L 


一 
从 左 向 右 依次 执行 


图 2-9 Maven 生命 周期 
下 面 以 常用 的 Maven 命令 为 例 ， 讲 解 其 执行 的 生命 周期 阶段 : 
(1) mvn clean: 该 命令 调用 clean 生命 周期 的 clean 阶段 。 实 际 执行 的 阶段 为 clean 生命 周期 
的 pre-clean 和 clean 阶段 。 
(2) mvn test: 该 命令 调用 default 生命 周期 的 test 阶段 。 实 际 执行 的 阶段 为 default 生命 周期 
的 validate. initialize 等 直到 test 的 所 有 阶段 。 这 也 解释 了 为 什么 在 执行 测试 的 时 候 ， 项 目 代码 
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能 够 自动 得 到 编译 。 


(3) mvn clean install: 调 用 clean 生命 周期 的 clean 阶段 和 default 生命 周期 的 install 阶段 。 实 


际 执行 为 clean 生命 周期 的 pre-clean、clean 阶段 以 及 default 生命 周期 


有 阶段 。 


的 从 validate 至 install 的 所 


(4) mvn clean deploy site-deploy: 调 用 clean 生命 周期 的 clean 阶段 、default 生命 周期 的 
deploy 阶段 以 及 site 生命 周期 的 site-deploy 阶段 。 实 际 执 行 的 阶段 为 clean 生命 周期 的 pre- 
clean、clean 阶段 ，default 生命 周期 的 所 有 阶段 和 site 生命 周期 的 所 有 阶段 。 


2.4.2 Maven 插件 
Maven 常用 的 插件 见 表 2-8. 


表 2-8 Maven 常用 插件 


插件 名 称 插件 的 artifactld 
动 定义 打包 maven-assembly-plugin 
SCP 文件 传输 copy-maven-plugin 
源码 分 析 maven-pmd-plugin 
代码 格式 检查 maven-checkstyle-plugin 
单元 测试 报告 maven-surefire-report-plugin 
TODO 检查 报告 taglist-maven-plugin 
Java 代码 的 度量 工具 javancss-maven-plugin 
JavaDoc maven-javadoc-plugin 
FireBug 检查 findbugs-maven-plugin 
查找 重复 依赖 duplicates-finder-plugin 
Windows 系统 默认 使 用 GBK 编码 格式 ，Java 项 目 经 常 使 用 的 编码 为 UTF-8， 需 要 在 
compiler 插件 中 进行 相应 设置 ， 否 则 中 文 乱码 可 能 会 导致 编译 错误 。 


<plugin> 


使 用 插件 maven-compiler-plugin 设 定编 译 的 IDK 版 本 和 编码 格式 ， 如 下 所 示 : 


<groupld>org.apache.maven.plugins</groupId> 
<artifactlId>maven-compiler-plugin</artifactld> 


<version>3.7.0</version> 
<configuration> 
<source>1.8</source> 
<target>1.8</target> 
<encoding>UTF-8</encoding> 
</configuration> 
</plugin> 


2.43 生命 周期 与 插件 的 关系 


Maven 的 生命 周期 本 身 是 不 做 任何 实际 工作 的 ， 实 际 的 任务 操作 都 交 给 插件 来 完成 。 生 命 


周期 抽象 了 构建 的 各 个 步骤 ， 定 义 了 步骤 执行 的 顺序 ， 但 是 没有 基体 实现 ， 其 体 的 实现 


Wo BH Maven 通过 这 种 插件 的 机 制 ， 使 得 每 个 构建 的 步骤 都 可 以 绑 定 一 个 或 者 多 个 插件 


mH. Maven 内 置 了 很 多 默认 的 插件 。 让 使 用 者 在 大 多 数 的 时 间 里 ， 感 觉 不 到 插件 的 存在 。 当 


机 制 提供 了 足够 的 扩展 空间 ， 使 用 者 可 以 
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的 行为， 


TON 


己 配 置 插 件 或 者 自 定义 插件 来 构建 特定 的 行为 。 
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2.5 Maven 聚合 和 继承 


Maven 的 聚合 特性 能 够 把 一 个 项 目的 各 个 模块 聚合 在 一 起 进行 构建 。Maven 的 继承 特性 能 
够 帮助 抽取 相同 的 依赖 和 插件 等 配置 ， 在 简化 pom 的 同时 ， 还 能 够 -sa 
促进 各 个 模块 配置 的 一 致 性 。 > EB sre/mainjiava 


(® src/test/java 


Bi, JRE System Library [JavaSE-1.8 


2.5.1 Ay Ase m ae Dependencies 


假设 有 两 个 Maven 项 目 ， 分 别 为 工程 child01 和 工程 child02， 8pm 
如 图 2-10 所 示 。 两 个 项 目 并 行 开发 时 ， 需 要 分 别 到 两 个 模块 目录 中 ee 


® src/test/java 


执行 mvn 命令 进行 构建 。 如 果 并 行 的 项 目 更 多 会 造成 命令 执行 操作 > BRES terar nose 


BA Maven Dependencies 


非常 烦琐 。 而 Maven 聚合 可 以 实现 执行 一 次 命令 ， 构 建 多 个 模块 。 = 
下 面 对 child01 和 child02 两 个 项 目 进行 聚合 操作 。 E pomami 

创建 另外 一 个 项 目 parent， 通 过 该 项 目 构建 项 目 组 所 有 模块 。 图 2-10 项 目 结构 
parent 作为 一 个 Maven 项 目 ， 必 须 拥 有 自己 的 pom 文件 。 在 Eclipse 


中 创建 此 项 目 时 要 选择 maven-archetype-site-simple。 此 parent 项 目 不 作为 业务 代码 开发 使 用 。 
parent 项 目 pom 文件 关键 部 分 配置 如 下 : 
<project xmlins="http://maven.apache.org/POM/4.0.0" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 
http://maven.apache.org/xsd/maven-4.0.0.xsd"> 
<model Version>4.0.0</model Version> 


<groupId>com.javadevmap.demo</groupId> 
<artifactld>parent</artifactld> 
<version>0.0.1—SNAPSHOT</version> 
<packaging>pom</packaging> 
<modules> 
<module>../child01</module> 
<module>../child02</module> 
</modules> 
..// 省 略 


</project> 


parent 项 目 中 的 packaging 配置 必须 为 pom。 在 parent 项 目 中 运行 clean package MS, MA 
分 别 在 child01/child02 下 生成 对 应 的 jar 包 ， 如 图 2-11 所 示 。 


INFO 
[INFO] --- maven-install-plugin:2.4:install (default-install) @ parent --- 

INFO] Installing D:\WorkSpace\parent\pom.xml to C:\Users\Administrator\.m2\repos 
[INFO] ---------------------------------------------------------------------+--- 
INFO] Reactor Summary: 

INFO] 
[INFO] childðt .o.2s0c ds siec cd eeae carecdmaedas sass enaeenee SUCCESS [ 3.175 s] 
INFO] child? © ons cc's esd i wasees aves else cee SUCCESS [ 9.769 s] 
[INFO] parent csc seca pL a secsece SUCCESS [ 9.018 s] 
[INFO] ------------------------------------------------------------------------ 
INFO] BUILD SUCCESS 

INFO] ------------------------------------------------------------------------ 
[INFO] Total time: 4.147 s 

INFO] Finished at: 2018-@3-@3T21:48:19+08:00 

[INFO] Final Memory: 11M/15@M 

[INFO]. = 


图 2-11 运行 结果 
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2.5.2 Maven 的 继承 


如 果子 项 目 child01，child02 需要 继承 项 目 parent 中 的 pom 配置 ， 那 么 就 需要 使 用 Maven 


的 继承 。 在 子 项 目 中 添加 配置 : 


<parent> 
<groupId>com.javadevmap.demo</groupId> 
<artifactld>parent</artifactld> 
<version>0.0.1—SNAPSHOT</version> 


<relativePath>../parent/pom.xml</relativePath> 


</parent> 
parent 元 素 中 的 属性 对 应 的 都 是 父 项 目 中 的 内 容 。 在 parent 元 素 中 还 有 一 个 属性 
relativePath, maven 会 通过 这 个 路 径 去 查找 父 项 目的 pom.xml 文件 ， 如 果 找 不 到 会 ier 中 
查找 。relativePath 的 默认 值 是 .jpom.xml， 也 就 是 默认 父 项 目的 pom 在 上 一 层 目录 。 由 于 当前 
parent 项 目 与 已 有 项 目 平 级 ， 这 里 就 需要 指定 pom 文件 的 位 置 。 可 继承 的 pom 元 素 见 表 2-9, 
表 2-9 可 继承 的 pom TH 

groupld 项 目 组 ID 

version 项 目 版 本 

description 项 目 描述 

organization 项 目的 组 织 信 息 

inceptionYear 项 目的 创建 年 份 

url 项 目的 url 地 址 

developers 项 目的 开发 者 信息 

contributors 项 目 贡 献 值 信息 

distributionManagement 项 目的 部 署 配置 

issueManagement 项 目的 缺陷 跟踪 系统 信息 

ciManagement 项 目 持续 集成 系统 信息 

scm 项 目的 版 本 控制 系统 消息 

mailingLists 项 目的 邮件 列表 信息 

properties 定义 的 maven 属性 

dependencies 项 目的 依赖 配置 

dependencyManagement 项 目的 依赖 管理 配置 

repositories 项 目的 仓库 配置 

build 项 目的 源码 目录 配置 、 输 出 目录 配置 、 插 件 配置 、 插 件 管理 配置 等 

reporting 项 目的 报告 输出 目录 配置 等 


2.5.3 Maven 中 dependencyManagement 的 使 用 


子 项 目 都 会 继承 父 项 目的 依赖 关系 ， Sees 目 不 需 要 父 项 


dependencyManagement 元 素 能 让 子 项 目 继承 到 父 


的 依赖 关系 ，Maven 提供 的 


目的 依赖 配置 等 


属性 〈 如 版 本 信息 )， 确 保 子 


模块 的 灵活 性 ， 同 时 dependencyManagement righ 明 不 会 引入 实际 的 依赖 。 


父 项 目 中 使 用 该 元 素 声 明 的 依赖 既 不 会 给 父 项 目 引 入 依赖 也 不 会 给 子 项 目 引 入 依赖 ， 但 是 


该 配置 会 被 继承 。 如 果子 项 目 中 不 声明 经 过 父 项 目 


dependencyManagement 修饰 的 依赖 ， 那 么 子 


项 目 就 不 会 引入 该 依赖 。 子 项 目 如 果 要 使 用 父 项 目 
74 


中 经 过 dependencyManagement 修饰 的 依赖 ， 


E 


N 


<dependencyManagement> 

<dependencies> 

<dependency> 

<groupId>junit</groupId> 
<artifactld>junit</artifactld> 
<version>4. 12</version> 
<scope>test</scope> 
</dependency> 
<dependency> 
<groupId>com.google.code.gson</groupId> 
<artifactld>gson</artifactld> 
<version>2.8.2</version> 

</dependency> 
</dependencies> 


</dependencyManagement> 


! 需 要 定义 groupld Fil artifactld 即 可 。 例如 parent 项 目 有 以 下 配置 : 


第 2 Maven 


子 项 目 要 使 用 父 项 目的 JUnit 和 Gson 依赖 ， 不 需要 添加 版 本 号 信息 ， 只 需 向 dependencies 


中 加 入 如 下 依赖 配 : 


。 aH 


<dependencies> 
<dependency> 
<groupld>junit</groupld> 
<artifactld>junit</artifactld> 
</dependency> 
<dependency> 
<groupld>com.google.code.gson</groupId> 
<artifactId>gson</artifactld> 
</dependency> 
</dependencies> 


Maven 继承 机 人 


bill LL Xe dependencyManagement 元 素 能 解决 不 同 模块 相同 依赖 构件 版 本 不 一 致 


问题 。 注 意 ， 是 dependencyManagement 而 非 dependencies。 也 许 读者 已 经 想到 在 父 模块 中 配置 


所 有 子 模块 都 


dependencies, JK 
这 么 做 是 有 问题 的 


需要 spring-aop， 却 也 直接 继承 了 。dependencyManagement 就 没有 这 相 


动 继承 ， 不 仅 达到 了 依赖 一 致 的 目的 ， 还 省 掉 了 大 段 代 码 。 


~ 


， 例 如 将 模块 child01 的 依赖 spring-aop 提取 到 了 父 模块 中 ， 但 模块 child02 不 


的 问题 ，dependency 


133) 


Management 只 会 影响 现 有 依赖 的 配置 ， 但 不 会 引入 依赖 。 


依赖 一 致 性 ， 消 除 


在 多 模块 Maven 项 目 中 ，dependencyManagement 几乎 是 必 不 可 少 的 ， 用 它 能 够 有 效 地 维护 


多 模块 插件 配置 重复 。 
2.5.4 Maven 中 的 pluginManagement 的 使 用 
与 dependencyManagement 类 似 ， 也 可 以 使 用 pluginManagement 元 素 管 理 插件 。 一 个 常见 的 


所 有 模块 使 用 Maven Compiler Plugin 的 时 候 ， 都 使 用 Java 1.8， 以 及 指定 Java 
源 文件 编码 为 UTF-8， 这 时 可 以 在 父 模块 的 pom 文件 中 对 pluginManagement 进行 如 下 


用 法 就 是 希望 项 
配置 : 
<build> 
<pluginManagement> 
<plugins> 
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<plugin> 
<groupId>org.apache.maven.plugins</groupId> 
<artifactId>maven-compiler-plugin</artifactId> 
<version>3.7.0</version> 
<configuration> 
<source>1.8</source> 
<target>1.8</target> 
<encoding>UTF-8</encoding> 
</configuration> 
</plugin> 
</plugins> 
</pluginManagement> 
</build> 


这 段 配置 会 被 应 用 到 所 有 子 横 块 的 maven-compiler-plugin 中 ， 由 于 Maven WE J maven- 
compiler-plugin 与 生命 周期 的 绑 定 ， 因 此 子 模块 就 不 再 需要 任何 maven-compiler-plugin 的 配 
置 了 。 

通常 所 有 项 目 对 于 任意 一 个 依赖 的 配置 都 应 该 是 统一 的 ， 但 插件 却 不 是 这 样 ， 例 如 你 希望 
模块 A 运行 所 有 单元 测试 ， 模 块 B 要 跳 过 一 些 测试 ， 这 时 就 需要 配置 maven-surefire-plugin 插 
件 来 实现 ， 那 样 两 个 模块 的 插件 配置 就 不 一 致 了 。 也 就 是 说 ， 简 单 地 把 插件 配置 提取 到 父 pom 
的 pluginManagement 中 往往 不 适合 所 有 情况 ， 因 此 在 使 用 的 时 候 就 需要 注意 了 ， 只 有 那些 普 适 
的 插件 配置 才 应 该 使 用 pluginManagement 提取 到 父 pom 中 。 
虽然 Maven 只 是 用 来 帮助 构建 项 目 和 管理 依赖 的 工具 ，pom 也 并 不 是 正式 产品 代码 的 一 音 
分 ， 但 也 应 该 认真 对 待 pom。 随 着 敏捷 开发 和 TDDS 等 方式 越 来 越 被 人 接受 ， 测 试 代码 得 到 了 
开发 人 员 越 来 越 多 的 关注 。 因 此 不 能 仅 满足 于 一 个 能 用 的 pom， 而 应 该 积极 地 修复 pom 中 使 用 
不 当 的 地 方 。 


CST 


© TDD 是 测试 驱动 开发 《Test-Driven Development) 的 英文 简称 ， 是 敏捷 开发 中 的 一 项 核心 实践 和 技术 ， 也 是 一 种 设计 方法 论 。 
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本 章 会 介绍 两 个 优秀 的 版 本 管理 工具 Svn 和 Git 


Svn 是 集中 式 版 本 控制 系统 ， 版 本 库存 放 在 中 央 服 务 器 ， 必 须 联网 才能 工作 。 


Git 是 分 布 式 版 本 控制 系统 ， 也 就 是 每 个 研发 人 员 从 中 心 版 本 库 的 服务 器 上 拉 取 代码 后 会 在 
的 计算 机 上 克隆 一 个 自己 的 版 本 库 。 工 作 的 时 候 不 需要 联网 ， 因 为 版 本 都 在 自己 的 计算 机 上 。 


3.1 Svn 


Svn (Apache Subversion 


录 每 一 次 文件 和 目录 的 修改 。 


Cu 


) 是 一 个 开放 源 代 码 的 版 本 控制 系统 。 文 件 存放 在 中 心 版 本 库 ， 记 
Syn 允许 把 数据 恢复 到 早期 版 本 ， 或 是 检查 数据 修改 的 历史 。Svn 


可 以 通过 网 络 访问 它 的 版 本 库 ， 从 而 使 用 户 在 不 同 的 计算 机 上 进行 操作 ， 在 编写 代码 的 时 候 ， 


会 生成 很 多 不 同 版 本 的 代码 ， 
的 版 本 管理 中 解放 出 来 。 


3.1.1 Svn 客户 端的 安装 


Svn 的 使 用 需要 客户 端 软件 ， 本 书 选 
常 简单 ， 通 过 如 下 几 步 即 可 完成 软件 的 安装 ; 


使 用 Svn 可 以 有 效 管理 不 同 版 本 的 代码 ， 从 而 把 研发 人 员 从 烦琐 


日 TortoiseSVNS 客 户 端 。TortoiseSVN 客户 端的 安装 非 


C1) 通过 搜索 找到 下 载 地 址 ， 或 者 直接 去 TortoiseSVN 的 官网 https://tortoisesvn.net/ 


downloads.html 进行 下 载 。 下 载 时 选择 中 文 TortoiseSVN 的 正确 版 本 即 可 。 在 编写 本 书 时 ， 最 新 


版 本 为 LanguagePack 1.9.7.27907-x64-zh_CN.msiS 。 


(2) 双击 执行 安装 。 运 行 后 程序 会 让 你 选择 安装 路 径 ， 设 定 “ 攻 阅 
好 文件 夹 后 即 可 一 步 步 操作 直至 安装 完成 。Svn 版 本 信息 如 图 3-1 


所 示 。 
3.1.2 Svn 基本 使 用 


下 面 介 绍 使 用 Svn 来 管理 项 目 。 


1. 获取 项 目 文件 SVN Checkout 图 3-1 Svn 版 本 信息 


可 以 根据 Svn 服务 器 的 
将 项 目 Checkout 到 本 地 。 


如 图 3-2 所 示 。 


也 址 ， 例 如 svn://39.106.10.196/javadevMapSvnS 以 及 用 户 名 和 密码 ， 


(1) 首先 在 本 地 创建 一 个 空 的 文件 夹 。 在 文件 夹 内 执行 “鼠标 右键 单 击 ->SVN checkout”. 


© TortoiseSVN 是 一 个 免费 的 Svn 客户 端 ， 并 且 很 好 地 结合 了 Windows 系统 ， 可 视 化 界面 使 它 直 观 且 易 于 使 用 。 


© msi 文件 是 Windows Installer 的 数据 包 ， 它 实际 上 是 一 个 数据 库 ， 包 含 安装 一 种 产品 所 需要 的 信息 和 在 很 多 安装 情形 下 安装 


ER) 程序 所 需 的 指令 和 数据 。 


© 此 处 及 后 面 使 用 的 卫 地 址 、 域 名 等 ， 均 为 本 书 编写 时 临时 使 用 的 测试 环境 地 址 ， 不 对 读者 提供 接口 或 访问 能 力 。 
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(2) 在 弹出 的 对 话 框 中 ， 输 入 Svn 的 服务 器 地 址 ， 如 图 3-3 所 示 。 


ZEV > 
EES), 2 B Checkout x 
分 组 依据 (P) > 
BRE) Repository 
BEM... URL of repository: 
粘贴 快捷 方式 (S Checkout directory: 
撤消 重 命名 (U) Ctrl+Z C:\Users\Administrator \Desktop \javaDevMapRepo 
Git Init Here Multiple, independent working copies 
Git Gui rete T: 
Git Bash ESED 
Fully recursive ~ 
极速 PDF 转 Word 
授予 访问 权限 (G) > Omit externals Choose items... 
内 Git Clone... e 
Ï Git Ci i here... 
Î Git Create repository here. © HEAD revision 
RÊ TortoiseGit > 
@ TortoiseSVN > 
ae ; Caneel | | Heb 
Ne Ba 
图 3-2 Svn 快捷 命令 图 3-3 配置 Svn 服务 器 地 址 


(3) 输入 地 


止 后 ， 点 击 OK， 会 弹出 一 个 对 话 框 ， 输 入 用 户 名 和 和 密码， 


否则 每 次 操作 都 需要 输入 用 户 名 和 密码 。 


(4) 进行 如 J 


2. 提交 本 地 文件 到 Svn 服务 器 


上 操作 后 ， 可 以 看 到 Svn 服务 器 的 文档 已 经 下 载 到 本 地 ， 如 


B Checkout Finished! - E x 
Action Path Mime t| 
Command Checkout from svn://39. 106. 10. 196/javadevMapSvr IE ullyr Externals induded 
Updating _—_C:\Users Administrator Desktop \javaDevMapRepo 


Completed At revision: 0 


Al3-4 Fer ay 


己 得 勾 选 保存 认证 ， 


图 3-4 所 示 。 


C1) 将 要 上 传 的 文件 放 到 Svn 管理 的 文件 夹 内 ， 然 后 在 文件 夹 上 执行 “鼠标 右键 单 击 ~ 


TortoiseSvn—>Add 


.…” 在 弹出 的 对 话 框 中 多 选 需要 上 传 的 文件 ， 然 后 点 击 


认 对 话 框 ， 点 击 OK。 此 时 会 发 现 文件 夹 或 者 文件 上 面 会 有 一 个 小 加 号 。 


(2) 再 次 在 文件 夹 的 空白 处 执行 “鼠标 右键 


写本 次 提交 的 备注 ， 然 后 点 击 OK 即 可 。 


3. Svn 更 新 


更 新 本 地 代码 至 Svn 服务 器 | 
白 处 执行 “鼠标 右 鲁 
键 单 击 ->Update to revision...” ). 


(SVN Update) 


OK。 会 弹出 一 个 确 


单 击 一 SVN Commit...”， 在 弹出 的 输入 框 中 填 


上 最 新 版 本 ， 只 要 在 需要 更 新 的 文件 夹 上 或 者 在 文件 图 标 旁 空 


4. 删除 Svn 服务 器 上 的 文件 


如 果 被 删除 的 文件 还 未 加 入 Svn 版 本 库 


~ 


本 库 ， 则 使 用 如 下 方法 删除 : 


单 击 ~> SVN Update” 即 可 (如 果 要 获取 指定 历史 版 本 的 内 容 ， 执 行 “ 鼠 标 右 


直接 删除 文件 即 可 ;如 果 要 删除 的 文件 已 加 入 版 


方法 一 ， 选 择 要 删除 的 文件 ， 执 行 “ 鼠 标 右键 单 击 ->TortoiseSVN-> Delete”， 然 后 选择 待 删 


除 文件 的 上 级 目录 ， 执 行 “ 鼠 标 右键 单 击 -~> SVN Commit...”， 并 填写 备注 。 
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方法 二 ， 在 计算 机 中 直接 删除 该 文件 ， 然 后 选择 被 删除 文件 的 父 目 录 ， 执 行 “鼠标 右键 单 
击 -> SVN Commit...”， 在 变更 列表 中 选择 被 删除 的 文 


ps Gg KEN Ss B’ C:\Users\Administrator\Desktop\javaDevMapRepo... X 
件 ， 填 写 备 注 并 提交 。 
Revision 
5. SVN 还 原 (SVN Revert) Giese Sane 


进入 Svn 文件 夹 中 ， 执 行 “鼠标 右键 单 击 ->Tortoise Ea 
SVN->Update to revision...”， 然后 会 弹出 一 个 窗口 ， 如 eeh -~ 
3-5 所 示 。 [Z] Make depth sticky 

例如 回 退 到 第 4 个 版 本 只 需要 选择 Revision， 并 在 输 si ETA 
入 框 中 填写 相应 的 版 本 号 ， 然 后 点 击 OK 即 可 。 È 


6. 锁定 和 解锁 (Get lock and Release lock) E 
RAIRE, Da 将 无 法 修 ” 
ou Svn 具备 文件 锁定 的 能 力 ， 锁 定 后 他 人 将 无 法 修改 此 图 3.5 SmE 
选中 要 锁定 的 文件 ， 执 行 “ 鼠 标 右键 单 击 ->TortoiseSVN->Get lock...” HTE, RRA 


出 锁定 信息 框 。 当 文本 文件 锁定 后 ， 需 要 通过 解锁 ， 他 人 才能 继续 对 文件 进行 修改 。 在 被 锁定 
的 文件 上 执行 “鼠标 右键 单 击 ->TortoiseSVN-> Release lock...” 进 行 解锁 。 

7. 重 命名 文件 (Rename) 

要 修改 文件 名 ， 可 选中 需要 重 命名 的 文件 或 文件 夹 ， 然 后 执行 “鼠标 右键 单 击 ~>TortoiseSVN 
->Rename...” 在 弹出 的 对 话 框 中 输入 新 名 称 ， 点 击 OK 按钮 ， 并 将 修改 文件 名 后 的 文件 或 文件 
夹 通过 执行 “鼠标 右键 单 击 ->SVN Commit...” 提 交 到 Svn 服务 器 上 。 

8. 获取 历史 文件 (Show log) 

Show log 有 显示 日 志 的 作用 ， 主 要 是 显示 某 文件 或 目录 已 经 执行 的 操作 ， 包 含 被 谁 修改 了 
以 及 修改 的 时 间 和 上 日期。 执行 “鼠标 右键 单 击 ~>TortoiseSVN-> Show log”， 会 显示 某 路 径 下 的 
所 有 文件 版 本 信息 。 


3.1.3 Svn 解决 冲突 


为 什么 会 产生 冲突 代码 呢 ? 原因 很 简单 ， 因 为 不 同 的 人 ， 同 时 修改 
了 同一 个 文件 的 同一 个 地 方 ， 其 中 一 个 人 提交 了 ， 另 一 个 人 就 提交 不 了 = 


a Px [Pp x = 国 ep Mpg i @ code. 
了 。 如 果 另 一 个 人 要 提交 代码 ， 需 要 先进 行 更 新 ， 然 后 解决 冲突 后 才能 。 SS 
提交 。 |_| code.txt.r1 
如 果 产生 冲突 ，Svn 会 生成 如 下 3 个 文件 ， 用 于 帮助 解决 冲突 。 如 ee 
3-6 所 示 。 图 3-6 Svn 冲突 文件 
E code txtmine 是 你 修改 后 准备 提交 的 版 本 ， 即 没有 提交 成 功 的 版 本 。 


E code.txtrl 是 冲突 前 本 地 的 版 本 。 
E code.txtr2 是 别人 赶 在 你 之 前 提交 的 版 本 。 
查看 code.txt WAZA, Hki F: 


<<<<<<< .mine 


lisi change it||||||| .r1 


Zhangsan change it>>>>>>> 12 


其 中 ，<<<<<<<<.mine 与 一 一 -之 问 的 代码 是 你 自己 的 ， 而 一 一 一 与 >>>>>>>.2 之 间 
的 代码 是 别人 与 你 冲突 的 部 分 。 
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解决 方案 如 下 。 
d) 在 发 生 冲 突 的 文件 上 执行 “鼠标 右键 单 击 -> TortoiseSVN->Edit conflicts”， 弹 出 编辑 对 
话 框 ， 如 图 3-7 所 示 。 


3 5 code.txt.mine - TortoiseMerge 一 口 x 


< Edit syle ~@ O 
=) N r g ef | © > © o| © 


Save Reload py Copy Paste Find Goto Markas | Navigate} Use left | Whitespaces|| Diff || View 
X line resolved Me blocky X o X 


Edit te Blocks 


Theirs - code.txt.r2 Mine - code.txt.mine 


+1 Zhangsan- change iti!  [-}1lisi-change i c 


图 3-7 Svn 冲突 编辑 对 话 框 
注意 上 面 一 共有 三 个 窗口 ， 三 个 窗口 的 含义 见 表 3-1。 


表 3-1 冲突 解决 窗口 含义 


f 名 称 合 义 
Theirs 为 服务 器 上 当前 最 新 版 本 
Mine 为 本 地 修改 后 的 版 本 
Merged 为 合并 后 的 文件 内 容 显 示 
对 话 框 中 有 许多 颜色 ， 含 义 见 表 3-2。 


表 3-2 ”冲突 解决 窗口 颜色 含义 


mo 6 含 AX 
浅黄 色 新 增 或 修改 的 内 容 
gé 表示 没有 发 生 任何 变化 的 部 分 
红色 当前 行 出 现 了 冲突 


在 红色 块 处 单 击 鼠 标 右键 ， 就 会 弹出 如 图 3-8 所 示 的 菜单 ， 根 据 菜 单 中 的 选项 ， 进 行文 件 
的 合并 操作 o Use this text block 


E use this text block: 选取 选中 行 的 内 Xs = ET F 'mine' before 'theirs' 

E use this whole file: 选取 选中 行 所 在 文件 的 全 部 内 容 。 2 text block from 'theirs' before ‘mine’ 

E use text block from mine before theirs: 先 用 自己 的 内 容 ， > | 
接着 用 别人 的 图 3-8 Svn 解决 冲突 选项 


E use text block from theirs before mine: 先 用 别人 的 内 容 ， 接 着 再 用 自己 的 。 
(2) 根据 上 面 的 操作 步骤 ， 解 决 完 冲突 后 ， 选 择 save， 然 后 选择 “Mark as resolved”， 最 后 
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在 Svn 文件 夹 中 执行 “鼠标 右键 单 击 -~>SVN Commit...” BPEJ. 
3.1.4 Svn 分 支 


在 建立 项 目 版 本 库 时 ， 可 首先 建 好 项 目 文 件 来 ， 并 在 其 中 建立 trunk, branches, tags 三 个 空 的 
子 目 录 。 这 三 个 目录 的 作用 如 下 : 
i 常 开发 进行 的 地 方 。 
E branches 是 分 支 。 一 些 阶 段 性 的 发 布 版 本 ， 是 可 以 继续 进行 开发 和 维护 的 ， 则 放 在 
branches 目录 中 。 或 者 对 于 项 目 不 同 的 开发 版 本 也 可 以 放 在 此 分 支 中 。 
E tags 目录 一 般 是 只 读 的 ， 这 里 存储 阶段 性 的 发 布 版 本 ， 只 是 作为 一 个 里 程 碑 的 版 本 进行 
存档 。 


3.2 Git 


Git 不 同 于 SVN， 它 可 以 在 没有 
Git 的 用 法 。 
3.2.1 Git 客户 端 安装 

本 书 选 用 msysGit 作为 Git 客户 端 。Git 客户 端的 安装 非常 简单 ， 通 过 如 下 几 步 即 可 完成 ; 

C1) 通过 搜索 找到 下 载 地 址 ， 或 者 直接 去 Git 的 官网 https://gitforwindows.org/ 进 行 下 载 。 下 
载 时 选择 中 文 Git 的 正确 版 本 即 可 。 在 编写 本 书 时 ， 最 新 版 本 为 Git-2.16.2-64-bit.exe. 

(2) 双击 执行 安装 。 运 行 后 程序 会 让 你 选择 安装 路 径 ， 设 定好 文件 夹 后 即 可 一 步 步 操 作 直 
至 安装 完成 。 安 装 完成 后 ， 在 开始 菜单 里 单 击 “Git Bash Here”， 弹 出 一 个 类 似 命令 行 窗口 的 界 
面 ， 就 说 明 Git 安装 成 功 。 

(3) 设置 全 局 用 户 名 和 邮箱 。 执 行 “ 鼠 标 右键 单 击 ->Git Bash Here”, 在 弹出 的 命令 行 中 分 
别 输 入 下 面 的 命令 。 


$ git config —global user.name "Your Name" 
$ git config 一 global user.email '"Youremail@example.com" 


RAR NTT FRETAR REMEE, AST PEAR ST? 


md 


QS 


3.2.2 Git 基本 使 用 


在 使 用 Git 之 前 ， 有 必要 了 解 一 下 Git 的 几 个 重要 概念 : Git 工作 区 、 和 暂 存 区 和 版 本 库 
m 工作 区 (Working directory): 简单 地 说 是 在 计算 机 里 能 看 到 的 目录 。 
m HFX Cstage): 用 来 暂时 存放 工作 区 中 修改 的 内 容 。 
图 版 本 库 (Repository): 工作 区 里 有 一 个 名 为 git 的 隐藏 目录 ， 这 个 目录 不 算 工 作 区 ， 而 
是 Git 的 版 本 库 。 
Git 基础 环境 准备 妥当 后 ， 需 要 先 从 远程 仓库 克隆 项 目 文件 。 准 备 好 远程 仓库 ， 例 如 
git@gitee.com:hwhe/JavaDeveloperMap.git9， 这 里 打开 “Git Bash Here” 命 令 行 ， 用 命令 git clone 
克隆 一 个 本 地 库 。 


$ git clone git@gitee.com:hwhe/JavaDeveloperMap.git 


pA 


O Gitee: 码 云 (gitee.com) 是 开源 中 国 社区 团队 推出 的 基于 Git 的 快速 的 、 免 费 的 、 稳 定 的 在 线 代码 托管 平台 
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本 节 使 用 的 远程 仓库 是 通过 Oschina 创建 的 ，Oschina 给 出 的 地 址 不 1 


FF 一个， 还 可 以 用 


https://gitee.com/hwhe/JavaDeveloperMap.git 这 样 的 地 址 。 实 际 上 ，Git 支持 多 种 协议 ， 默 认 使 用 ssh, 


但 也 可 以 使 月 


前 ， 


Git 常用 命令 如 下 : 


E git clone 复制 一 个 仓库 到 本 地 


用 git clone 复制 一 个 


$ git clone [url] 


Git 仓库 至 


E git add 添加 文件 到 缓存 


$ git add test.java 


E git status 查看 当前 Git KAS, ORM 


$ git status 


E git commit 保存 到 本 地 仓库 中 
E 送 到 本 地 仓 
需要 先 执行 git add 将 修改 放 入 暂 存 
也 提交 的 备注 
远程 仓库 


git commit 是 将 修改 


$ git commit -m 'A} 


an 送 


E git push 


H https 等 其 他 协议 。 区 别 为 https 方式 每 次 push 都 必须 输入 口令 。 


| 本地， 能 够 查看 该 项 


IK 


区 中 。 


git push 命令 上 


$ git push < 远程 主机 名 > < 本 地 分 支 名 >:< 远 程 分 支 名 > 


注意 ， 分 文 


送 顺 序 的 写法 是 < 来 源 地 >:< 


I>, M git push 后 面 跟 < 本 地 分 支 >:< 远 程 分 支 >。 


则 会 


$H, 


的 版 本 。 注 意 : 
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如 果 省 略 远程 分 支 名 ， 则 表示 将 本 地 分 支 
两 者 同名 )， 如 果 该 远程 分 支 不 存在 ， 则 会 被 创建 。 


$ git push origin master 


上 面 命令 表示 ， 将 本 地 的 master 分 支 推送 到 origin 主机 的 master 分 支 。 如 果 后 者 不 存在 


被 创建 。 


E git pull 同步 远程 分 文 到 本 地 


$ git pull 


如 果 本 地 没有 配置 SSH 公 钥 ， 则 需要 
可 以 免 去 输入 用 户 名 和 密码 ， 有 具体 配置 方法 在 3.2.5 节 会 有 详细 介绍 。 


库 中 。 使 用 mm 选项 可 以 设置 提交 注释 。 执 行 此 命令 之 


， 或 者 进行 修改 。 


送 到 与 之 存在 “ 


民 据 提示 输入 


E git reset 和 revert 代码 回 湾 
第 一 种 情况 ， 还 没有 push, pa 4 是 在 本 地 commit. 


1) 找到 之 前 提交 的 git commit 的 id 信息 


$ git log 


a 


BERKA” ALTE C 


] 于 将 本 地 分 支 的 更 新 ， 推 送 到 远程 主机 。 它 的 格式 与 git pull 命令 相仿 。 


的 地 >， 所 以 git pull 后 面 跟 < 远 程 分 支 >:< 本 地 


yale 


1H 币 


] 户 名 和 密码 才能 更 新 。 


日 


um SSH 公 


2) 找到 想 要 撤销 的 id， 执 行 git reset 命令 ， 完 成 撤销 ， 同 时 将 代码 恢复 到 commit id 对 应 


hard 参数 的 作 


$ git reset —hard <commit_id> 


或 者 


用 是 使 修改 的 代码 也 


H 


滚 到 commit id 的 版 本 。 
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$ git reset <commit id> 


不 带 参数 hard， 则 仅 完 成 commit 命令 的 撤销 ， 不 对 代码 修改 进行 撤销 ， 可 以 直接 通过 git 
commit 重新 提交 本 地 修改 的 代码 。git reset 常用 参数 见 表 3-3。 


表 3-3 git reset 常用 参数 


窗口 名称 E XN 
—mixed 为 默认 方式 。 回 退 到 某 个 版 本 ， 只 保留 源码 ， 回 退 commit 和 index 信息 
—soft 可 退 到 某 个 版 本 ， 只 回 退 commit 的 信息 
一 hard 彻底 回 退 到 某 个 版 本 ， 本 地 的 源码 也 会 变 为 目标 版 本 的 内 容 


第 二 种 情况 ，commit push 代码 已 经 更 新 到 远程 仓库 。 
对 于 已 经 把 代码 push 到 线 上 仓库 ， 如 果 回 退 本 地 代码 也 想 同 时 回 退 线 上 代码 ， 使 线 上 、 线 
下 代码 保持 一 致 ， 需 要 用 到 下 面 的 命令 : 


$ git revert <commit_id> G Puch to Upstream 


W Fetch from Upstream 


revert 之 后 本 地 代码 会 回 滚 到 指定 的 历史 版 本 ， 这 时 再 git push 即 hae 


s Commit... Ctrl+# 


可 把 线 上 的 代码 更 新 。 23 
git reset 是 回 退 到 某 次 提交 ， 提 交 及 之 前 的 commit 都 会 被 保留 ， ren 

但 是 此 次 之 后 的 修改 都 会 被 退回 到 暂 存 区 ，git revert 是 生成 一 个 新 的 。 mentees 

提交 来 撤销 某 次 提交 ， 此 次 提交 之 前 的 commit 都 会 被 保留 。 
当前 使 用 的 开发 工具 Eclipse 默认 带 有 Git 插件 ， 操 作 更 加 便利 。 “se 

例如 导入 项 目 ， 执 行 “file->import->Git”， 根 据 提示 输入 对 应 Git 信 App Patch 

息 ， 即 可 完成 Git 项 目 导入 。 
当 要 提交 代码 、 更 新 项 目 时 ， 只 需 在 项 目 上 执行 “鼠标 右键 单 击 >> sse 

Team” 操 作对 应 的 菜单 即 可 ， 如 图 3-9 所 示 。 图 3-9 Eclipse 中 的 Git 菜单 


3.2.3 Git 分 支管 理 
在 Git 开发 过 程 中 ， 经 常 需要 使 用 分 支 操作 把 当前 的 代码 从 开发 主 分 支 master 上 分 离开 
来 ， 在 不 影响 主 分 支 的 情况 下 继续 工作 。 分 文 也 是 Git 的 优秀 特性 之 一 。 
E 查看 已 有 的 分 文 
$ git branch —a 
E 创建 一 个 分 支 
$ git branch < 分 文 名 > 
图 切换 分 文 
$ git checkout -b < 分 支 名 > 
E 合并 分 文 (注意 是 当前 的 分 文 合并 其 他 分 支 ): 
$ git merge < 其 他 分 文 名 > 


3.2.4 Git 标签 


Git 可 以 针对 某 一 个 时 间 点 的 版 本 打 一 个 标签 (tag)， 例 如 当前 开发 了 一 个 稳定 版 本 ， 可 以 
用 “gittag .…” 命令 打 一 个 标签 留 作 标记 。 
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标签 相关 命令 如 下 : 
E 查看 所 有 标签 

$ git tag 
图 创建 标签 

$ git tag < 标签 名 > 
图 删除 标签 


$ git tag -d < 标签 名 > 


图 切换 标签 
$ git checkout < 标签 名 > 


图 发 布 标签 提交 到 Git 服务 器 
$ git push origin < 标签 名 > 


通常 的 git push 不 会 将 标签 对 象 提 交 到 Git 服务 器 ， 所 以 需要 进行 显 式 的 操作 。 
3.2.5 在 Git 中 配置 SSH 


Git 使 用 https 协议 ， 每 次 pull、push 都 会 提示 输入 密码 ， 如 果 使 用 Git 协议 ， 然 后 使 用 SSH 
密 钥 ， 这 样 可 以 免 去 每 次 都 输入 密码 的 麻烦 。 

初次 使 用 Git 的 用 户 要 使 用 Git 协议 一 般 需 要 三 个 步 又; 

C1) 生成 密 钥 对 。 

Git 服务 器 都 会 选择 使 用 SSH 公 钥 来 进行 授权 ， 每 个 用 户 必须 提供 一 个 公 钥 用 于 授权 ， 没 
有 的 话 就 要 生成 一 个 。SSH 公 钥 默认 储存 在 账户 主 目录 下 的 ~/.ssh 目录 中 。 目 录 中 有 .pub 后 
级 的 文件 就 是 公 钥 ， 男 一 个 文件 则 是 密 钥 (例如 id_rsa 和 id_rsa.pub )。 

假如 没有 这 些 文件 ， 甚 至 连 .ssh 目录 都 没有 ， 可 以 用 ssh-keygen 来 创建 。 该 程序 包含 如 
MsysGit 包 里 ， 打 开 “Git Bash Here” 命 令 行 执行 以 下 命令 : 

$ ssh-keygen -t rsa -C "your _email@youremail.com" 


然后 ， 系 统 会 提示 输入 密码 (建议 输入 密码 具备 一 定 的 安全 性 ， 当 然 不 输入 也 是 可 以 的 )， 
按照 提示 设置 完成 后 ， 本 地 的 密 钥 对 就 生成 了 。 
(2) 设置 远程 仓库 (以 码 云 为 例 ) 上 的 公 钥 。 
进入 本 机 当前 登录 用 户 下 面 的 ”~/.ssh”* 目 录 ， 执 行 “ 鼠 标 右键 单 击 -> Git Bash Here”， 执 行 
“cat ~/.ssh/id_rsa.pub” 命 令 ， 查 看 生成 的 公 钥 。 
$ cat ~/.ssh/id_rsa.pub 


复制 生成 的 公 钥 的 内 容 ， 登 录 但 云 账 号 ， 点 击 “ 头 像 -> 设 置 ” 然后 点 击 左边 菜单 的 SSH 
公 钥 ， 复 制 上 面 的 公 钥 内 容 ， 粘 贴 进 “ 公 钥 value” 文 本 域内 。 在 公 钥 标题 域 ， 起 一 个 名 字 。 
(3) 把 Git HY remote url 修改 为 Git 协议 。 
如 果 之 前 的 代码 已 经 使 用 Git 协议 ， 则 这 一 步 可 以 略 过 ， 如 果 之 前 使 用 的 是 用 https 协议 下 
载 的 代码 ， 可 以 使 用 如 下 命令 查看 并 修改 协议 类 型 。 
$ git remote -v 
origin https://gitee.com/hwhe/spring—mvc. git (fetch) 
origin https://gitee.com/hwhe/spring-mvc.git (push) 


= 


È 
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从 码 云 项 目 上 复制 Git 协议 的 相应 的 url， 执 行 gitremote set-url 来 调整 url。 


$ git remote set—url origin git@gitee.com:hwhe/JavaDeveloperMap.git. 


3.2.6 JH Git stash 暂 存 代码 


本 节 讲 解 git stash， 它 可 用 来 暂 存 当 前 正在 进行 的 工作 ， 例 如 想 pull 最 新 代码 ， 又 不 想 提交 
当前 代码 。 常 常 遇 到 的 情况 就 是 ， 为 了 修改 一 个 紧急 的 bug， 先 暂 存 当 前 代码 ， 然 后 迁 出 之 前 的 
代码 ， 修 改 完 bug 后 提交 代码 ， 最 后 从 暂 存 区 取出 暂 存 的 代码 。 

git stash 使 用 步骤 如 下 : 

(1) 保存 当前 修改 。 

git stash 会 把 所 有 未 提交 的 修改 〈 包 括 暂 存 的 和 非 暂 存 的 ) 都 保存 起 来 ， 用 于 以 后 恢复 当前 
工作 内 容 。 同 时 注意 ，git stash 是 本 地 的 ， 不 会 随 push 命令 上 传 到 服务 器 上 。 

$ git stash 
$ git status 

通过 上 面 的 命令 ， 可 以 将 当前 代码 恢复 到 最 近 提交 的 状态 ， 这 样 就 可 以 先 去 执行 其 他 紧急 
的 任务 。 例 如 切换 到 其 他 分 文 ， 修 改 bug， 修 改 完 后 ， 再 切换 到 之 前 的 分 支 ， 继 续 上 次 没 修改 完 
的 内 容 。 
(2) 恢复 之 前 临时 缓存 的 内 容 。 

$ git stash pop 

上 面 的 命令 可 以 将 缓存 堆栈 中 的 第 一 个 stash 删除 ， 并 将 对 应 修改 应 用 到 当前 的 工作 目 
下 。 也 就 是 恢复 到 上 一 个 stash 命令 执行 之 前 的 状态 。 

(3) 查看 所 有 的 stash. 


$ git stash list 


(4) 移 除 stash， 注 意 这 里 的 stash 的 名 称 ， 可 以 从 stash list 输 旨 
$ git stash drop <stash 名 称 > 
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用 户 、 多 从 
和 网 络 协 议 。Linux 


和 使 月 


ar. 


Viva 
Fl 


oF 4 


在 日 常 工 作 中 ， 
基本 的 Linux 命令 对 看 


4.1 Linux 简介 


Linux 是 一 套 免费 使 用 和 自 
E 务 、 支 持 多 线程 和 多 CPU 的 


是 一 个 性 能 稳定 的 多 上 


发 者 来 讲 尤 为 


Linux 提供 了 大 量 的 命令 ， 可 以 有 
作 、 进 程 管理 、 文 从 
频率 最 高 的 命令 
Linux 命令 格式 如 下 ， 


权限 设 定 等 。 


Linux 命令 


通常 测试 环境 和 生产 环境 的 软件 都 是 运行 在 Linux 服务 器 
EE 要 。 本 章 将 讲解 Linux 系统 的 常 月 


Abb 


4.2 Linux 常用 命令 


jj 户 操作 系统 。 


$ command [-options] [parameter1] ... 


Linux 发 行 版 最 少 


命令 参数 含义 见 表 4-1。 


表 4-1 Linux 命令 参数 


Hare. 


它 能 运行 主要 的 UNIX 工具 软件 、 


上 ， 了 解 # 


应 有 


效 地 完成 大 量 的 工作 ， 如 磁盘 操作 、 文 件 存 取 、 目 


的 命令 也 有 200 多 个 ， 这 里 只 介绍 比较 重 


握 


传播 的 类 UNIX 操作 系统 ， 是 一 个 基于 POSIX 和 UNIX 的 多 


操作 系统 。 程序 


名 称 ae N 

command 命令 名 ， 相 应 功能 的 英文 单词 或 单词 的 缩写 

[-options] 选项 ， 可 用 来 对 命令 进行 控制 ， 也 可 以 省 略 ，[] 代 表 可 选 
parameterl .…. 传 给 命令 的 参数 : 可 以 是 零 个 、 一 个 或 者 多 个 


(1) 查看 帮助 文档 


1) 一 help 
在 Linux 命令 后 加 J 
$ Is --help 


2) man(manual) 


man 是 Linux 提供 
章节 (section), EH 


$ man Is 


SA 


(2) Linux 


动 补 全 


HD 


E--help 参数 可 显 


t 的 一 个 手册 ， 包 含 了 绝 大 部 分 的 命令 、 函 数 使 


示 命 令 自 带 的 帮助 信息 。 例 如 : 


(3) 查看 历史 输入 的 命令 


$ history 
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可 以 指定 不 同 的 章节 来 浏览 。 例 如 ， 


H man 时 


月 说 明 ， 该 手册 


用 户 敲 出 命令 的 前 几 个 字母 后 ， 可 按 下 tab 键 ， 系 统 会 自动 补 全 命令 。 
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当 系 统 执 行 过 一 些 命 令 后 ， 执 行 history 命令 会 将 执行 过 的 命令 列举 出 来 。 也 可 按 上 下 键 翻 看 
以 前 的 命令 。 
(4) df -h 查看 当前 磁盘 使 用 情况 。 
$df—h 
(5) free 显示 当前 系统 未 使 用 的 和 已 使 用 的 内 存 大 小 ， 还 可 以 显示 内 核 使 用 的 内 存 缓冲 
小 。“h” 的 作用 是 人 性 化 输出 内 存单 位 。 
$ free —h 
输出 内 容 中 每 列 的 含义 见 表 4-2。 


x 
> 


表 4-2 free 命令 输出 内 容 


列 名 称 含 x 
total J 存 总 数 
used 己 使 用 的 内 存 数 
free 空闲 的 内 存 数 

shared 当前 已 经 废弃 不 用 的 内 存 数 

buffers/cache 缓存 内 存 数 

available 估计 可 提供 内 存 数 

(6) PUT shell 脚本 文件 。 假 设 已 经 有 了 一 个 具有 执行 权限 的 shell 脚本 文件 start.sh， 那 么 


此 文件 有 以 下 两 种 执行 方式 ; 
1) sh 命令 执行 shell 脚本 
$ sh start.sh 
2)“./" 前 缀 局 动 shell 脚本 
$ ./start.sh 
(7) 打包 和 解压 文件 。 在 Linux 系统 中 经 常 需要 打包 和 解压 文件 。 下 面 介 绍 zip 包 和 tar 包 
的 打包 和 解压 命令 。 
1) zip 包 的 打包 命令 
$ zip test.zip fileZip 
将 fileZip 打包 成 一 个 zip 格式 的 名 为 test.zip 的 压缩 包 。 
2) 解压 testzip。 
$ unzip test.zip 
3) tar 包 的 打包 命令 
$ tar -czvfpng.targztestpng 
将 当前 目录 下 面 的 testpng 打包 成 一 个 名 为 png.tar.gz 的 包 。 
4) 解压 png.tar.gz 
$ tar -xzvf png.tar.gz 


tar 命令 参数 的 含义 见 表 4-3 6 
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一 


表 4-3 tar 命令 参数 
=c 创建 压缩 文档 
-x 解压 
-z 调用 gzip 压缩 〈 解 压 ) 
-y 显示 命令 运行 全 过 程 
-f 使 用 文件 名 。 注 意 ， 这 个 参数 只 能 是 最 后 一 个 参数 ， 后 面具 能 接 文件 名 ， 即 -f 文件 名 
4.3 Linux 文件 管理 
本 节 将 介绍 文件 操作 的 基本 命令 以 及 文件 权限 的 级 别 和 使 用 。 


4.3.1 Linux 文件 操作 命令 
d) 查看 文件 信息 : Is 


ls 是 英文 单词 list 的 简写 ， 其 功能 为 列 出 目录 的 内 容 ， 是 Linux 系统 最 常用 的 命令 之 一 ， 它 
类 似 于 DOS FH dir 命令 。 
$1s 
常用 参数 见 表 4-4。 
表 4-4 js 常用 参数 
参数 含义 
-a 显示 指定 目录 下 所 有 的 子 目 录 与 文件 ， 包 括 隐藏 文件 
+ 以 列表 形式 显示 文件 的 详细 信息 
-h 配合 -1 以 友好 的 方式 显示 文件 大 小 
(2) 分 屏 显 示 : more 
查看 内 容 时 ， 当 信息 过 长 无 法 在 一 屏 上 显示 时 ， 会 出 现 快速 滚屏 ， 使 得 用 户 无 法 看 清文 件 


出 显示 ， 按 下 h 键 可 以 获取 帮助 。 
$more < 文件 名 > 
(3) 管道 命令 ; | 
一 个 命令 的 输出 可 以 通过 管道 作为 另 一 个 命令 的 输入 。“|” 的 左 端 输入 东西 〈 写 )， 右 端 读 


取 东 西 〈 读 )。 


$ Is -Ih | more 


(4) 切换 工作 目录 : cd 
cd 命令 可 以 切换 工作 目录 ， 常 用 的 cd 命令 见 表 4-5. 
表 4-5 cd 常用 命令 
cd~ 切换 到 当前 用 户 的 主 目录 (home/ 用 户 目 录 ) 
cd. 切换 到 当前 目录 
cd.. 切换 到 上 级 目录 
cd- 切换 到 上 次 所 在 的 目录 
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(5) 显示 当前 路 径 : pwd 
使 用 pwd 命令 可 以 显示 当前 的 工作 目录 ， 该 命令 很 简单 ， 直 接 输 入 pwd 即 可 ， 后 面 不 带 参数 。 

$ pwd 
(6) 创建 目录 : mkdir 

$ mkdir mapDir 
通过 mkdir 命令 可 以 创建 一 个 新 的 目录 。 参 数 -p 可 递归 创建 目录 。 需 要 注意 的 是 新 建 目录 的 名 
称 不 能 与 当前 的 目录 中 已 有 的 目录 或 文件 同名 ， 并 且 目 录 创 建 者 必须 对 当前 目录 具有 写 权 限 。 

(7) 删除 文件 ,mm 

可 通过 rm 删除 文件 或 目录 。 使 用 rm 命令 要 小 心 ， 因 为 文件 删除 后 不 能 恢复 。 为 了 防止 文 
件 误 删 ， 可 以 在 rm 后 使 用 -i 参数 以 逐个 确认 要 删除 的 文件 。 

$ rm test.txt 


rm 命令 常用 参数 以 及 含义 见 表 4-6。 


表 4-6 rm 参数 


EB E X 
-i 删除 已 有 文件 或 目录 之 前 先 询问 用 户 
强制 删除 文件 或 目录 

rR 递归 删除 ， 指 定 目 录 下 的 所 有 文件 与 子 目录 一 并 处 理 
-v 显示 指令 详细 执行 过 程 


(8) 删除 目录 : rmdir 
可 使 用 rmdir 命令 删除 一 个 目录 。 执 行 此 命令 时 必须 离开 待 删 除 目 录 ， 并 且 目 录 必 须 为 空 目 
录 ， 否 则 提示 删除 失败 。 


$ rmdir mapDir 
(9) 文件 搜索 : find 


$ find / -name test.log 


上 面 命 令 的 含义 是 : 从 根 文件 系统 开始 搜索 名 称 为 testlog 的 文件 。 


4.3.2 Linux 文件 权限 
Linux 的 文件 权限 分 为 读 、 写 、 执 行 三 种 ， 可 以 使 用 ls -1 进行 查看 。 见 表 4-7。 


j3 


表 4-7 文件 权限 


2 数 wx 
r 可 读 的 权限 ， 数 值 表示 为 4 
w 写 文件 的 权限 ， 对 于 目录 ， 可 以 创建 新 的 文件 ， 数 值 表示 为 2 
x 可 执行 ， 对 于 目录 ， 可 以 进入 ， 数 值 表示 为 1 
= 无 对 应 的 权限 


仔细 观察 ， 会 发 现 与 权限 相关 的 标记 总 共有 9 个 ， 每 3 个 为 一 个 小 组 。 三 个 小 组 的 含义 见 
表 4-8。 
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表 4-8 分 组 权限 
组 il E AX 
第 一 组 文件 所 有 者 的 权限 
第 二 组 文件 所 有 组 的 权限 
第 三 组 其 他 人 权限 ， 不 是 所 有 者 ， 也 不 在 所 有 组 里 面 
例如 ， 要 修改 文件 权限 ， 执 行 如 下 命令 
$ chmod 754 javaMap.txt 


根据 表 4-8， 上 面 的 命令 含义 如 下 。 
(1) 7=4+2+1， 表 示 文 件 所 有 者 : 


可 读 可 写 可 执行 权限 。 


(2) 5=4+1， 表 示 文 件 所 属 组 : 拥有 可 读 可 执行 权限 ， 但 是 没有 写 权 限 。 


py 


(3) 4 代表 其 他 : 拥有 可 


44 Linux 启动 服务 


在 Linux 中 常用 aoe 动 Java 服务 方式 有 两 种 。 
两 种 服务 的 启动 方式 。 


形式 的 服务 。 接 下 来 ， 


(1) 以 tomcat 容器 为 例 ， 
服务 。 


常用 的 命令 如 下 : 


分 别 演示 这 


1) 进入 tomcat 的 bin 目录 
$ cd /usr/local/tomcat8.524/bin 


2) 执行 tomcat 启动 命令 


$ ./catalina.sh start 
3) 关闭 


$ ./catalina.sh stop 


4) 


limi 


tomcat 服务 


重启 tomcat 服务 


$ ./catalina.sh restart 


5) 


查看 服务 启动 日 志 


RN 


读 权限 。 


$ cd /usr/local/tomcat8.524/logs 
$ tail -f catalina.out 


WY 


6 


$ ps -ef | grep tomcat 


(2) 在 Linux 服务 器 上 以 后 台 服 务 的 方式 启动 jar 程序 : 


1) nohup 命令 
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查看 tomcat 服务 是 否 存活 


一 种 是 放 在 容器 


在 Linux 环境 下 将 war 包 放 到 tomcat 容器 后 


在 讲解 如 何 后 台 启 动 Java 程序 之 前 ， 先 讲解 一 下 nohup 命令 。 

nohup 是 不 挂 断 的 运行 命令 ， 即 如 果 你 正在 运行 一 个 进程 ， 而 且 要 
束 ， 那 么 可 以 使 用 nohup 命令 。 该 命令 可 以 在 退出 账户 或 者 关闭 终端 之 后 继续 运 
Fe. nohup 可 以 理解 为 不 挂 起 的 意思 (no hang up)。 此 命令 的 语法 为 : 


B 面 的 war 包 


， 一 种 是 jar 


人 退出 账户 时 该 进程 不 结 


, JAZ) tomcat， 运 行 


双 行 相应 的 进 


nohup Command Arg ... | [&] 
nohup 命令 可 以 和 数据 流 进行 交互 。Linux 操作 系统 中 有 三 个 常用 的 数据 流 ， 见 表 4-9. 


FE = 
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表 4-9 数据 流 


数据 流 数 字 E X 
0 标准 输入 流 stdin 
1 标准 输出 流 stdout 
2 标准 错误 流 stderr 


在 nohup 命令 : 


s ft 


使 用 “> console.txt” 参 数 时 ， 实 际 是 “1 > console.txt” 的 省 略 用 法 ， 


即 标准 输出 重 定向 到 console.txt SHEA; 而 “<console.txt” 参 数 实际 是 “0 < console.txt” 的 省 略 


用 法 ， 是 将 console.txt 输入 到 标准 输入 流 中 。 


2) 启动 Java 服务 


mj 


局 动 一 个 jar 包 服 务 ， 要 先 定位 到 jar 包 所 在 的 目录 下 面 ， 然 后 执行 下 面 的 命令 : 


$ nohup java -jar xx.jar >/dev/null & 


导向 空 的 设备 


$ jps 


可 以 使 用 不 同 的 命令 参 


jps 命令 可 以 查看 有 权限 访问 的 Java 虚拟 机 进程 。 使 用 此 命令 可 以 查看 运行 的 Java 程序 。 


数 ， 对 启动 的 Java 程序 进行 配置 。 


注意 /dev/null 代表 空 设备 文件 。 该 命令 表示 上 面 的 启动 Java 服务 的 输出 是 不 需要 的 ， 直 接 


了 


$ nohup java -jar -Xmx512M —Xms128M testjar > nohup.out 2>&1 & 
以 上 命令 指定 Java 程序 启动 时 内 存 为 128MB， 最 大 内 存 为 S12MB。 同 时 输出 内 容 不 打印 


让 该 命令 在 后 台 执 行 。 


到 屏幕 上 ， 而 是 输出 到 nohup.out 文件 中 。 
准 输出 已 经 指定 为 nohup.out 文 伯 


Java 程序 启动 时 堆 内 存 参数 见 表 4-10。 


2>&1 是 将 标准 错误 流 重 定向 到 标准 输出 ， 这 里 的 标 


FEF， 所 以 标准 错误 流 也 输出 到 nohup.out 文件 中 。 最 后 一 个 & ， 是 


表 4-10 Java 程序 启动 时 堆 内 存 参数 


数据 流 数字 E X 
Xms 程序 启动 时 占用 内 存 大 小 
Xmx 程序 运行 期 间 最 大 可 占用 的 内 存 大 小 
Xss 每 个 线程 的 堆栈 大 小 
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第 一 篇 分 别 讲解 了 Java 语言 、Maven 工程 构建 、 代 码 管理 和 服务 器 命令 ， 这 些 内 容 组 合 起 
来 距离 一 个 可 以 支撑 业务 运行 的 服务 来 说 好 像 还 很 远 。 

如 果 一 个 业务 请 求 通 过 HTTP 协议 发 送 到 Java 程序 ， 程 序 如 何 承接 请 求 、 如 何 转化 协议 为 
对 象 、 如 何 把 请 求 映 射 到 业务 处 理 逻 辑 ? 如 果 业 务 请 求 希 望 得 到 一 个 可 以 展示 的 页 面 ， 那 么 如 
何 绘制 页 面 并 且 正确 地 返回 给 请 求 方 ? 如 果 某 个 业务 希望 永久 保存 某 些 数据 ， 那 么 就 不 能 把 数 
据 存 储 在 程序 内 存 中 ， 数 据 需要 通过 数据 库 进 行 持 久 化 操作 ， 如 何 通 过 程序 操作 数据 库 ? 如果 
这 些 问题 要 自己 一 一 解决 将 会 非常 困难 。 好 在 现在 有 许多 非常 成 熟 的 服务 框架 可 以 使 用 ， 例 如 
常用 的 SSH (Struts+Spring+Hibernate ) 框架 或 者 SSM (Spring+ SpringMVC+MyBatis ) 框架 。 

框架 可 以 帮助 解决 上 面 列 出 的 大 部 分 通用 的 基础 问题 ， 研 发 人 员 只 需要 使 用 框架 进行 正确 
的 配置 并 完成 业务 的 特殊 逻辑 就 可 以 实现 业务 需求 。 本 篇 会 介绍 这 些 框架 的 原理 和 核心 的 用 
法 ， 通 过 Spring 进行 服务 管理 ， 通 过 Spring MVC 进行 业务 流程 控制 ， 通 过 MyBatis 进行 持久 化 
操作 。 然 后 会 介绍 Spring Boot 工程 ， 它 会 使 框架 对 业务 的 影响 更 小 ， 配 置 更 简单 。 

通过 SSM 框架 已 经 可 以 进行 程序 的 业务 研发 工作 了 ， 但 是 此 框架 对 于 承载 大 型 互联 网 业务 
可 能 存在 一 些 葡 端 5。 例 如 在 同一 工程 中 ， 代 码 间 的 耦合 和 依赖 会 是 一 个 问题 ; 部 分 修改 尤其 是 
基础 模块 的 修改 需要 整个 项 目的 编译 及 系统 测试 ， 会 是 一 种 人 力 成 本 的 浪费 ; 某 些 模块 能 力 需 
要 对 外 开放 时 ， 传 统 架 构 对 单一 模块 的 扩展 无 法 支撑 也 是 一 个 问题 。 诸 如 此 类 的 问题 非常 多 ， 
其 实 汇聚 为 一 点 ， 就 是 大 系统 不 灵活 。 

为 了 解决 义 上 问题 ， 微 服务 的 理念 应 运 而 生 。 简 单 来 讲 ， 微 服务 就 是 把 一 个 大 系统 拆 分 成 
很 多 个 小 系统 ， 每 个 小 系统 独立 运行 ， 承 担 某 一 部 分 能 力 ， 这 样 可 以 让 单独 一 个 小 系统 承担 的 
竹 务 更 加 纯粹 ， 人 负责 这 块 系统 的 研发 人 员 也 可 以 更 加 专注 。 微 服务 的 好 处 很 多 ， 总 体 来 看 它 确 
实 优化 了 很 多 传统 框架 无 法 解决 的 问题 。 但 是 把 一 个 大 程序 拆 分 成 很 多 小 程序 ， 也 会 带 来 很 多 
问题 。 因 为 程序 间 是 通过 网 络 调用 的 ， 不 像 传统 架构 是 程序 内 部 调用 ， 那 么 程序 间 的 网 络 通信 
是 微服 务 要 解决 的 问题 ; 还 有 程序 间 的 调用 关系 链 及 依赖 问题 、 服 务 间 互 相 调用 时 的 服务 发 现 
问题 等 。 微 服务 的 引入 带 来 的 问题 主要 通过 微服 务 框架 进行 解决 ， 所 以 本 篇 还 会 介绍 Spring 
Cloud 微服 务 框 架 。 

希望 读者 通过 本 篇 的 学 习 ， 能 够 对 服务 整体 的 运行 原理 有 所 认识 ， 能 够 亲手 搭建 一 个 传统 
框架 的 服务 和 一 套 微 服务 框架 的 服务 。 


O 虽然 作者 认为 错误 都 是 人 造成 的 ， 框 架 不 应 该 承担 这 些 责 任 ， 但 是 如 果 能 够 通过 框架 降低 人 为 犯错 的 概率 也 是 个 不 错 的 选择 。 
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o Spring 


Spring959 是 一 个 轻 量 级 JavaSE/JavaEE 开发 应 用 框架 ?9， 可 以 一 站 式 地 构建 企业 应 用 。Spring 


是 模块 化 的 ， 几 乎 涵盖 了 开发 所 需要 的 所 有 组 件 ， 如 果 业 务 需求 超出 其 能 力 ， 也 可 方便 集成 第 


三 方 组 件 。Spring 可 以 管理 对 象 ， 还 提供 了 适用 于 安全 控制 、 异 常 处 理 、 日 志 记录 等 场景 的 面 
向 切面 的 能 力 ， 同 时 ，Spring 提供 与 第 三 方 框架 无 颖 集成 能 力 ， 进 一 步 方 便 业务 开发 和 拓展 。 


5.1 Spring 概述 


Spring 框架 | 


5.1.1 核心 模块 


下 面 简要 


7 个 核心 模块 组 成 。Spring 模块 构建 在 核心 容器 之 


上 ， 核 心 容器 定义 了 创 


建 、 配 置 和 管理 Bean 的 方式 。 


述 每 个 模块 的 作用 。 
E Spring Core: Core 封装 包 是 框架 的 最 基础 部 分 ， 提 供 IoC 和 依赖 尘 


E 入 特性 。 


E Spring Context: 构建 于 Core 封装 包 基 础 上 的 Context 封装 包 ， 提 供 了 一 种 框架 式 的 对 象 


访问 方法 。 


E Spring DAO: DAO (Data Access Object) 提 供 了 JDBC 的 抽象 
码 ， 能 解析 数据 库 厂商 特有 的 错误 代码 。JDBC 封装 包 还 提 作 
明 性 事务 管理 方法 ， 不 仅 实 现 了 特定 接口 ， 而 ] 
objects) 都 适用 。 

E Spring ORM: ORM 封装 包 提 供 了 党 月 


R, JHB SICH) JDBC 编 
t 了 一 种 比 编程 性 更 好 的 声 
对 所 有 的 POJOs (plain old Java 


昌 的 “对 象 / 关 系 ” 映 射 的 集成 层 。 


E Spring AOP: Spring 的 AOP 封装 包 提 供 了 面向 切面 的 编程 实现 ， 从 而 减弱 了 代码 的 功能 


co 


AEE AY REE TT ATF 


E Spring Web: Spring 中 的 Web 包 提供 了 基础 的 针对 Web 开发 的 集成 特性 。Spring 提供 对 


常见 框架 如 Struts、webwork、JSF 
架 ， 也 能 在 这 些 


的 文 持 ， 能 够 管理 这 些 框架 ， 将 资源 注入 给 这 些 杠 


下 次 的 前 后 插入 拦截 器 。 


E Spring Web MVC: Spring 中 的 MVC 封装 包 提 供 了 Web 应 月 


(MVC) 实现 。 


5.1.2 ”预备 知识 


在 学 习 Spring 之 前 ， 需 要 理解 以 下 几 个 概念 。 


图 POJO: Plain Old Java Objects， 简 单 的 Java 对 象 。 


m 容器 : 在 


中 


常生 活 


容器 就 是 一 种 侣 放 东 5 


Spring 官网 是 http://spring.io。 


© 框架 : 
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提供 了 一 些 基 础 功能 ， 


简化 开发 ， 让 研发 人 员 更 加 专注 业务 逻辑 的 组 件 集合 。 


ij 的 器 具 ， 从 程序 设计 角度 看 ， 


日 的 Model-View-Controller 


器 是 管理 其 他 


ay 
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对 每 的 对 象 。 因 为 存在 放 入 、 拿 出 等 操作 ， 所 以 容器 还 要 管理 对 象 的 生命 周期 。 
m 控制 反 转 : 即 Inversion of Control， 缩 写 为 I oC， 控制 反 转 还 有 一 个 名 字 叫 作 依 赖 注入 
(Dependency Injection)， 就 是 由 容器 控制 程序 之 间 的 关系 ， 而 非 传 统 实现 中 由 程序 代码 
直接 操控 。 
E Bean: 一 般 指 被 容器 管理 的 对 象 ， 在 Spring 中 指 Spring IoC 容器 管理 的 对 象 。 


5.2 构建 第 一 个 Spring 工程 


Spring 的 核心 是 IoC 容器 ， 其 他 所 有 技术 都 是 基于 容器 实现 的 。 下 面 创建 一 个 Spring 项 
目 ， 通 过 Spring 创建 一 个 Product 类 实例 ， 来 演示 IoC 功能 。 
(1) 构建 工程 
在 Eclipse 中 执行 “File->New->Maven Project” 命 令 ， 在 弹出 的 对 话 框 中 选择 “Select an 
Archetype ”以 及 下 面 的 “Maven-archetype-quickstart” 选 项 ， 点 击 Next 按钮 ， 在 弹出 的 对 话 框 
中 输入 Maven 的 坐标 信息 ， 具 体 输入 信息 如 下 : 
<groupId>com.javadevmap</groupId> 
<artifactld>SpringBasic</artifactld> 
<version>0.0.1-SNAPSHOT</version> 
<packaging>jar</packaging> 
然后 点 击 Finish 按钮 ， 完 成 基本 的 Maven 项 目 构 建 。 
(2) 添加 依赖 
在 pom 文件 中 加 入 Spring Context 依赖 。 上 有 具体 如 下 : 
<dependency> 
<groupld>org.springframework</groupId> 
<artifactId>spring-context</artifactId> 


<version>4.3.3.RELEA SE</version> 
</dependency> 


(3) 添加 配置 文件 
Spring 配置 文件 是 用 于 指导 Spring 工厂 进行 Bean Æ, EAR Bean 实例 分 发 的 核心 组 成 部 
分 。 在 项 目的 resources 文件 夹 下 ， 新 建 Spring 配置 文件 spring-bean.xml。 即 在 resources 文件 夹 上 
执行 “鼠标 右键 单 击 ->new->Spring Bean Configuration File”, 文件 内 容 具 体 如 下 : 
<?xml version="1.0" encoding="UTF-8"?> 
<beans xmIns="http://www.springframework.org/schema/beans" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-—instance" 
xsi:schemaLocation="http://www.spring framework.org/schema/beans 
http://www.springframework.org/schema/beans/spring-beans.xsd"> 
qe 配置 信息 are 
</beans> 


(4) 创建 Product 的 POJO 类 ， 具 体 如 下 : 


public class Product { 
private int id; 
private String name; 


© 本 章 用 Bean 表示 类 实例 ，bean 表示 配置 文件 中 的 配置 。 
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public Product() { 

j 

public Product(int id, String name) { 
System.out.println("invoke method — Product(int id, String name)"); 
this.id = id; 
this.name = name; 


j 

public int getId() { 
return id; 

j 


public void setId(int id) { 
System.out.println("invoke method — setld"); 


this.id = id; 

} 

public String getName() { 
return name; 

} 


public void setName(String name) { 
System.out.println("invoke method — setName"); 
this.name = name; 


j 


(5) 配置 bean 标签 


需要 在 Spring -bean xml 文件 


5.3.3 节 介 绍 。 
<?xml version="1.0" encoding="UTF-8"?> 
<beans xmins="http://www.springframework.org/schema/beans" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 


xsi:schemaLocation="http://www.springframework.org/schema/beans 
http://www.springframework.org/schema/beans/spring—beans.xsd"> 


， 配 置 相应 的 资源 信息 。 这 里 bean 标签 的 作用 以 及 含义 会 在 


<! 一 配置 信息 一 > 
<bean id="beanId" class="com.javadevmap.bean.Product"></bean> 
</beans> 


(6) 构建 测试 
接 下 来 ， 在 sre/test/java 目录 下 面 创建 一 个 JUnit 的 测试 类 ， 具 体 如 下 : 


public class TestlocCaseStart { 

ApplicationContext ctx; 

@Test 

public void testCase() { 
ctx=new ClassPathXmlA pplicationContext("spring—bean.xml"); 
// 从 容器 中 获得 id 为 beanId 的 bean 
Product product=(Product)ctx.getBean("beanId"); 
System.out.println("ApplicationContext.getBean() = "+product); 


ApplicationContext.getBean() = com.javadevmap.bean.Product@3d921e20 
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执行 完 上 面 几 步 ， 即 可 通过 Spring 实例 化 一 个 Product 对 象 ， 可 以 直接 使 用 这 个 Product 对 


象 ， 而 不 用 关心 如 何 创 建 以 及 销毁 ， 这 些 都 是 
发 环境 。 接 下 来 会 在 此 环境 上 进行 其 他 功能 的 演示 。 


` 


Ade 
[AJ 


的 Spring 的 


5.3 IoC 


管 理 


至 此 ， 


的 。 


Spring 进行 


上 一 节 中 的 Product 类 实例 化 是 | 
模块 。IoC 是 Spring 框架 的 核心 内 
在 初始 化 时 先 读 取 配置 文件 ， 根 据 配置 文件 


IoC 容器 中 取出 需要 的 对 象 实例 。 
5.3.1 IoC 和 DI 基本 原理 


IoC (Inversion of Control), BN “#4 


BS 


» BERT 


义 好 的 对 象 交 给 容器 控制 。 这 与 传统 Java SE 3 
注入 ”。 组 件 之 间 的 依赖 关系 1 
| 件 之 中 。 依 赖 注入 的 目的 是 为 了 提升 组 件 重 用 的 频 
。 通 过 依赖 注入 机 制 ， 只 需要 简 
身 的 业务 功能 ， 而 不 需要 关心 


DI (Dependency Injection)， 即 “依赖 
容器 动态 地 将 某 个 依赖 关系 注入 到 组 
为 系统 搭建 一 个 灵活 、 可 扩 
EE 目标 需要 的 资源 ， 完 成 其 


即 
率 ， 并 

任何 代码 便 可 指 
处 ， 由 谁 实现 。 


Ke 


p”, 是 一 种 设计 思想 。 
EZE new 创建 对 象 的 程序 设计 方式 不 
容器 在 运行 期 决定， 


就 搭建 完成 一 个 最 


Spring 的 什么 功能 实现 的 呢 ? 这 要 归功 于 Spring 的 IoC 
使 用 XML 配置 ， 也 可 以 使 用 注解 配置 。Spring 容器 


创建 与 组 织 对 象 ， 并 存 入 容器 


在 Java 开发 ! 


PF， 运 行程 序 时 再 从 
，]oC 意味 着 将 定 


同 。 


LO 


的 配置 ， 而 无 需 


在 传统 应 用 开发 中 ， 


容器 来 创建 及 注入 依赖 对 象 。 
5.3.2 IoC 的 配置 使 用 


自己 主动 控制 并 他 


Spring ! 
AWE, BERR —— YEAR 
Spring 的 XML 配置 文件 的 


以 有 许多 属性 ， 其 中 有 两 个 重要 的 属性 : 


的 类 型 。 


IoC 的 配置 有 两 种 方式 ， 一 种 是 XML 实现 方式 ， 一 利 


民 元 素 是 beans， 每 个 组 件 使 


kt 体 的 资源 来 自 何 


1 


= 


建 依 赖 或 注入 对 象 的 方式 称 为 正 转 ， 而 反 转 则 是 由 


是 IoC 注解 实现 ， 两 种 方式 


通过 Spring 获取 Bean 对 象 有 如 下 几 种 方式 : 


必需 的 全 路 径 类 名 即 class 属性 ，IoC 容器 会 为 


m 不 指定 这， 只 配置 
端 必须 通过 接 
m 指定 id， 必 须 在 ToC 容器 


唯一 。 


“T getBean(Class<T> requiredType)” 获 取 Bean. 


图 指定 name， 必 须 在 IoC 容器 中 唯一 。 


内 容 如 下 : 


图 同时 指定 id 和 name，id 就 是 标识 符 
新 建 spring-bean-ioc.xml 文件 ， 使 用 上 


， 而 name 就 是 别名 ， 必 须 在 IoC 容器 中 唯 


n 
面 介 绍 的 几 种 方式 配置 之 前 定义 


<?xml version="1.0" encoding="UTF-8"?> 
<beans xmins="http://www.springframework.org/schema/beans" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-—instance" 
xsi:schemaLocation="http://www.springframework.org/schema/beans 
http://www.springframework.org/schema/beans/spring—beans.xsd"> 


] bean 元 素来 定义 ，bean 元 素 可 
id 和 class。id 表示 组 件 的 默认 名 称 ，class 表示 组 件 


生成 一 个 标识 ， 客 户 


的 product 类 。 核 心 
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<! 一 配置 信息 一 > 

<bean class="com.javadevmap.bean.Product"></bean> 

<bean id="beanId" class="com.javadevmap.bean.Product"></bean> 

<bean name="beanName" class="com.javadevmap.bean.Product"></bean> 

<bean id="beanId01" name="beanName01" class="com.javadevmap.bean.Product"></bean> 
</beans> 


那么 如 何 获取 上 面 配置 的 Bean 对 象 呢 ? 这 需要 用 到 ApplicationContext #4. Application 
Context 是 Spring 中 较 高 级 的 容器 ， 可 以 加 载 配置 文件 中 定义 的 bean， 构 建 为 Bean 对 象 ， 对 
Bean 集中 管理 ， 按 需 分 配 Bean. 

最 常 使 用 的 ApplicationContext 接口 实现 类 有 以 下 三 种 : 

E FileSystemXmlApplicationContext: 该 容器 从 XML 文件 中 加 载 已 定义 的 bean。 需 要 提供 
给 构造 器 XML 文件 的 完整 路 径 。 

E ClassPathXmlApplicationContext: 该 容器 从 CLASSPATH 中 的 XML 文件 加 载 己 定义 的 
bean。 不 需要 提供 XML 文件 的 完整 路 径 ， 正 确 配置 CLASSPATH 环境 变量 即 可 ， 因 为 
容器 会 从 CLASSPATH 中 搜索 bean 配置 文件 。 

E WebXmlApplicationContext: 该 容器 会 在 一 个 Web 应 用 程序 的 范围 内 加 载 已 在 XML 文件 

中 定义 的 bean. 
当 获 取 Application Context 的 上 下 文 后 ， 就 可 以 通过 getBean0) 方法 得 到 所 需要 的 Bean. iX 
个 方法 通过 配置 文件 中 的 bean ID 来 返回 一 个 真正 的 对 象 。 

根据 ApplicationContext 容器 获取 上 面 配置 的 Bean， 测 试 类 如 下 : 


public class TestIocCaseIoC { 

ApplicationContext ctx; 

@Test 

public void testCase() { 
ctx=new ClassPathXmlA pplicationContext("spring—bean—ioc.xml"); 
/从 容器 中 获得 id A Product 的 bean 
//Product proClass=(Product)ctx.getBean(Product.class); 
//System.out.println(" 不 指定 id， 只 配置 必须 的 全 限定 类 名 = "+proClass); 
Product pro=(Product)ctx.getBean("beanId"); 
System.out.println(" 指 定 id 获取 ="+pro); 
pro=(Product)ctx.getBean("beanName"); 
System.out.println(" 指 定 name 属性 获取 = "+pro); 
pro=(Product)ctx.getBean("beanId01"); 
System.out.println(" 指 定 id 和 name 获取 = "+pro); 


} 
结果 如 下 : 
指定 id 获取 =com.javadevmap.bean.Product@3d921e20 


指定 name 属性 获取 = com.javadevmap.bean.Product@36b4cef0 
指定 id Fl name 获取 = com.javadevmap.bean.Product@fad74ee 


注意 上 面 例子 ， 如 果 使 用 注释 中 的 ctx.getBean(Product.class) 方 法 获取 ， 会 报告 以 下 错误 : 


org.springframework.beans.factory. NoUniqueBeanDefinitionException: No qualifying bean of type 
[com.javadevmap.bean.Product] is defined: expected single matching bean but found 4: com javadevmap. 
bean.Product#0,beanId,beanName,beanId01 
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通过 class 方法 获取 Bean，Spring 发 现 有 四 个 实例 ， 但 并 不 清楚 用 哪个 ， 所 以 会 报错 ， 
节 会 介绍 用 @Qualifier 来 区 分 各 实例 ， 这 里 先 注释 掉 。 


R$ 


运行 本 例 ， 可 在 控制 台 看 到 输出 结果 ， 可 以 发 现 配 置 的 Bean 对 象 已 
只 


ClassPathXmlApplicationContext 容器 管理 。 之 后 的 业务 操作 也 不 需要 主动 创建 一 个 实例 ， 只 需 


配置 


bean 和 执行 获取 Bean 方法 即 可 。Bean 的 整个 生命 周期 由 Spring 进行 管理 。 


5.3.3 Bean 定义 


上 一 节 通 过 bean 标签 就 能 实现 从 容器 中 获取 Bean WH, bean 标签 对 Bean 的 容器 化 管理 非 
常 重要 ， 其 属 忻 和 作用 见 表 5-1。 


表 S$-1 bean 标签 


| 
要 


class 这 个 属性 是 必 填 的 ， 创 建 对 象 所 在 类 的 全 路 径 
id 这 个 属性 肯定 唯一 的 bean 标识 符 。 在 基于 XML 的 配置 元 数据 中 ， 可 以 使 用 id 或 name 属性 来 指定 
bean 标识 符 。 
scope 这 个 属性 用 来 指定 Bean 对 象 的 作用 域 
constructor-arg 通过 构造 函数 注入 
property 通过 Bean 的 setter 方法 注入 


了 解 了 bean 的 基本 配置 属性 后 ， 考 虑 这 样 一 个 场景 ， 在 某 些 对 象 实例 化 的 时 候 进行 初始 


化 操 
象 的 


入 (静态 工厂 方法 参数 不 允许 注入 )。 


Spring IoC 容器 注入 依赖 资源 主要 有 以 下 两 种 基本 实现 方式 : 


作 ， 例 如 通过 构造 函数 或 者 设置 属性 值 。 以 Product 类 为 例 ， 希 望 在 初始 化 Bean 时 将 对 
id 和 name 属性 进行 初始 化 ， 这 就 用 到 了 Spring 的 bean 标签 constructor-arg 和 property 
两 个 配置 项 。 


C1) 构造 器 注入 : 通过 在 bean 定义 中 指定 构造 器 参数 进行 注入 ， 包 括 实例 工厂 方法 参数 注 


使 用 constructor-arg 指定 构造 函数 初始 化 name 和 age 属性 值 ， 具 体 如 下 : 


<?xml version="1.0" encoding="UTF-8"?> 

<beans xmins="http://www.springframework.org/schema/beans" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-—instance" 
xsi:schemaLocation="http://www.springframework.org/schema/beans 
http://www.springframework.org/schema/beans/spring-beans.xsd"> 


<bean id="beanNoConstructorArg" class="com.javadevmap.bean.Product"></bean> 
<bean id="beanHasConstructorArg" class="com.javadevmap.bean.Product"> 
<constructor-arg name="id" value="1001"></constructor-arg> 
<constructor-arg name="name" value="java dev map"></constructor—arg> 
</bean> 
</beans> 


通过 ClassPathXmlApplicationContext 容器 获取 配置 的 Bean 实例 : 


public class TestIocCase02Constructor { 
ApplicationContext ctx; 
@Test 
public void testCase() { 
ctx=new ClassPathXmlApplicationContext("spring-bean-constructor.xml"); 
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/从 容器 中 获得 bean 

Product product=(Product)ctx.getBean("beanNoConstructorArg"); 
System.out.printIn("beanNoConstructorArg = "+product); 

Product productCon=(Product)ctx.getBean("beanHasConstructorArg"); 
System.out.printIn("beanHasConstructorArg = "+productCon); 


invoke method — Product(int id, String name) 
beanNoConstructorArg = com.javadevmap.bean.Product@13eb8acf 
beanHasConstructorArg = com.javadevmap.bean.Product@51c8530f 


(2) setter 注入 : 通过 setter 方法 进行 注入 。 
使 用 Property 注入 name 和 age 属性 值 ，XML 配置 如 下 : 
<?xml version="1.0" encoding="UTF-8"?> 
<beans xmlns="http://www.springframework.org/schema/beans" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 


xsi:schemaLocation="http://www.springframework.org/schema/beans 
http://www.springframework.org/schema/beans/spring—beans.xsd"> 


<bean name="beanProperty" class="com.javadevmap.bean.Product"> 
<property name="id" value="1002"></property> 
<property name="name" value="java dev map "></property> 
</bean> 


</beans> 


通过 ClassPathXmlApplicationContext 容器 获取 配置 的 Bean 实例 : 


public class TestIocCase03property { 

ApplicationContext ctx; 

@Test 

public void testCase() { 
ctx=new ClassPathXmlA pplicationContext("spring-bean-property.xml"); 
/从 容器 中 获得 id 为 Product 的 bean 
Product pro=(Product)ctx.getBean("beanProperty"); 
System.out.printIn("product= "+pro); 


invoke method 一 setld 
invoke method — setName 
product= com.javadevmap.bean.Product@2db7a79b 


到 这 里 ， 可 以 看 出 constructor-arg 和 property 两 者 均 可 实现 对 象 属 
的 方式 不 同 而 已 。 


5.3.4 Bean 的 作用 域 


在 学 习 本 节 之 前 ， 需 要 弄 明 白 什么 是 作用 域 。 作 用 域 (scope )， 简 单 来 说 是 指 Spring 容器 
P POJO 的 生命 周期 ， 也 可 以 理解 为 对 象 在 Spring 容器 中 的 创建 方式 。 


Le 


生 的 初始 化 ， 只 是 初始 化 


mi 


100 


第 5 章 Spring 


上 一 节 学 习 了 如 何 实例 化 Bean 以 及 如 何 进行 注入 ， 那 么 Spring 生成 的 Bean 是 单 例 模式 9 
的 还 是 原型 模式 2 的 呢 ? 
这 里 调用 两 次 getBean 方法 ， 比 较 两 个 Bean 是 否 相同 ， 修 改 之 前 的 测试 用 例如 下 ; 
public class TestlocCaseStartSingleton { 
ApplicationContext ctx; 
@Test 
public void testCase() { 
ctx=new ClassPathXmlApplicationContext("spring-bean.xml"); 
/从 容器 中 获得 id 为 beanId 的 bean 
Product product=(Product)ctx.getBean("beanId"); 
Product product2=(Product)ctx.getBean("beanId"); 
System.out.printIn("product==product2 is "+(product—product2)); 
} 
} 
运行 结果 如 下 


product—product2 is true 


可 以 发 现 Spring 默认 注入 的 Bean 是 单 例 模式 的 。 可 以 通过 设置 bean 标签 里 面 的 scope 属 
性 ， 指 定 Bean 的 作用 域 。 
<bean name="beanName" scope =" XXX” class="xxx"></bean> 
scope 属性 常用 singleton 和 prototype 两 种 属性 值 。 对 于 singleton 作用 域 的 Bean， 每 次 请 求 


该 Bean 都 将 获得 相同 的 实例 ， 即 3 


时 说 的 单 例 模式 的 Bean。 如 果 Bean 被 设置 成 prototype 作用 


域 ， 程 序 每 次 请 求 该 id 的 Bean, Spring 都 会 新 建 一 个 Bean 实例 ， 然 后 返回 。 作 用 域 的 含义 见 
K 5-2. 
表 5-2 作用 域 
作用 域 ae X 
singleton 单 例 模式 ， 在 整个 Spring IoC 容器 中 ， 使 用 singleton 定义 的 Bean 将 只 有 一 个 实例 
prototype 原型 模式 ， 每 次 通过 容器 的 getBean 方法 获取 prototype 定义 的 Bean 时 ， 都 将 产生 一 个 新 的 Bean 实例 
对 于 每 次 HTTP 请 求 ， 使 用 request 定义 的 Bean 都 将 产生 一 个 新 实例 ， 即 每 次 HTTP 请 求 将 会 产生 不 同 的 Bean 
”| 实例 。 只 有 在 Web 应 用 中 使 用 Spring 时 ， 该 作用 域 才 有 效 
对 于 每 次 HTTP Session， 使 用 session 定义 的 Bean 都 将 产生 一 个 新 实例 。 同 样 上 只 有 在 Web 应 用 中 使 用 Spring 
Sson f 时 ， 该 作用 域 才 有 效 
globalsession 每 个 全 局 的 HTTP Session, EH session 定义 的 Bean 都 将 产生 一 个 新 实例 
基于 定义 的 Product 类 ， 实 现 singleton 和 prototype 两 种 作用 域 的 Bean。XML 配置 如 下 : 


<?xml version="1.0" encoding="UTF-8"?> 
<beans xmIns="http://www.springframework.org/schema/beans" 


om: 


和 例 模式 ， 


xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xsi:schemaLocation="http://www.springframework.org/schema/beans 
http://www.springframework.org/schema/beans/spring—beans.xsd"> 

<bean name="beanNoScope" class="com.javadevmap.bean.Product"></bean> 
<bean name="beanPrototype" scope="prototype" 


E, 
Fe. 


种 常 


的 软件 设计 模式 。 在 它 的 核心 结构 9 


只 包含 一 个 被 称 为 单 例 的 特殊 类 。 通 过 单 例 模式 可 以 保 记 


FE 系统 中 应 


该 模式 的 类 只 有 一 个 实例 。 


© 原型 模式 : 每 次 注入 或 通过 上 下 文 获取 时 都 会 创 寻 


一 个 新 实例 。 
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class="com.javadevmap.bean.Product"></bean> 


</beans> 
通过 上 面 设 置 的 两 种 类 型 的 bean 来 获取 Bean 实例 。 测 试 类 核心 代码 如 下 : 


public class TestIocCase04scope { 
Product productOne; 
Product productT wo; 
ApplicationContext ctx; 


@Test 

public void testCase() { 
ctx=new ClassPathXmlApplicationContext("spring-bean-scope.xml"); 
/从 容器 中 获得 id 为 beanNoScope 的 bean 
productOne=(Product)ctx.getBean("beanNoScope"); 
productTwo=(Product)ctx.getBean("beanNoScope"); 
System.out.println("scope default productOne—productTwo is " 

+(productOne==productTwo)); 


/从 容器 中 获得 id 为 beanPrototype 的 bean 

productOne=(Product)ctx.getBean("beanPrototype"); 

productTwo=(Product)ctx.getBean("beanPrototype"); 

System.out.println("scope prototype productOne—productTwo is " 
+(productOne—=productTwo)); 


} 

结果 如 下 

scope default productOne—productTwo is true 
scope prototype productOne==productTwo is false 


通过 bean 的 scope 属性 ， 可 以 灵活 控制 Bean 的 作用 域 来 应 对 不 同 的 业务 场景 。 


5.3.5 Bean 的 生命 周期 


通过 前 面 几 节 ， 基 本 了 解 了 Spring 的 bean 的 使 用 、 注 入 以 及 配置 作用 域 。 那 么 Spring 是 怎 
么 实例 化 Bean 的 呢 ? 被 容器 管理 的 Bean 什么 时 候 创建 ， 以 及 什么 时 候 释放 呢 ? 本 节 讲 解 
Spring 的 Bean 的 装配 和 关闭 的 过 程 
Spring 装配 Bean 的 过 程 如 下 : 
1) 实例 化 Bean。 
2) 设置 属性 值 。 
3) 如 果实 现 了 BeanNameAware 接口 ， 调 用 setBeanName 设置 Bean 的 ID 或 者 Name。 
4) 如 果实 现 了 BeanFactoryAware 接口 ， 调 用 setBeanFactory 设置 BeanFactory。 
5) 如 果实 现 了 ApplicationContextAware 接口 ， 调 用 setApplicationContext 设置 Application- 
Context. 
6) 7 
7) 7 
8) 7 


9) 4 


Jij 


o 


z 


H BeanPostProcessor 的 预先 初始 化 方法 。 
H InitializingBean 的 afterPropertiesSet() 方 法 。 
日 定制 init-method 方法 。 

H BeanPostProcessor 的 后 初始 化 方法 。 


ZH 


ZH 


T 


ZH 
Tima 


ZH 
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Spring 销毁 Bean 的 过 程 如 下 : 

1) 调用 DisposableBean 的 destroy(). 

2) 调用 定制 的 destroy-method 方法 。 

下 面 重 点 讲解 初始 化 回调 函数 和 销毁 
业务 处 理 操 作 。 

CL) 初始 化 回调 函数 ， 有 两 种 实现 方式 : 

1) 通过 实现 org.springframework.beans.factory.InitializingBean 接口 。 
使 用 之 前 的 Product 类 进行 演示 ， 将 此 类 复制 一 份 ， 然 后 实现 InitializingBean 接口 ， 具 体 


四 
Hy 
四 
Hy 


HF Bean 的 初始 化 和 销毁 时 进行 


I 
al 
BE 
Or 
3% 
s 


a 


如 下 : 
package com.javadevmap.bean; 
import org.springframework.beans. factory. InitializingBean; 
public class ProductWithInitializingBean implements InitializingBean { 
private int id; 
private String name; 
public ProductWithInitializingBean() { 
} 
public ProductWithInitializingBean(int id, String name) { 
System.out.printIn("invoke method — Product(int id, String name)"); 
this.id = id; 
this.name = name; 
} 
// 省 略 get 与 set 方法 
@Override 
public void afterPropertiesSet() throws Exception { 
System.out.println("execute afterPropertiesSet()"); 
} 
} 
在 Spring 配置 文件 中 配置 bean 标签 ， 具体 如 下 : 


<?xml version="1.0" encoding="UTF-8"?> 

<beans xmins="http://www.springframework.org/schema/beans" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xsi:schemaLocation="http://www.springframework.org/schema/beans 
http://www.springframework.org/schema/beans/spring—beans.xsd"> 


<! 一 配置 信息 一 > 
<bean id="beanId" class="com.javadevmap.bean.ProductWithInitializingBean"></bean> 
</beans> 


编写 测试 代码 如 下 : 
public class TestlocCaseLifeCircleWithInterface { 

AbstractApplicationContext ctx; 

ProductWithInitializingBean bean; 

@Test 

public void testCase() { 
ctx=new ClassPathXmlA pplicationContext("spring—bean—initializingbean.xml"); 
System.out.println("execute one"); 
bean =(ProductWithInitializingBean) ctx.getBean("beanlId"); 
System.out.println("execute two"); 
bean =(ProductWithInitializingBean) ctx.getBean("beanld"); 
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execute afterPropertiesSet() 
execute one 
execute two 


观察 运行 结果 可 以 发 现 ， 实 现 InitializingBean 接口 的 类 仅仅 在 初始 化 的 时 候 调用 一 次 接口 方 
法 ， 由 于 此 bean 标签 配置 的 是 单 例 模式 ， 所 以 之 后 再 次 使 用 getBean 方法 时 接口 方法 没有 被 调用 。 


2) 在 


T 


CEEP init-method 属性 指定 无 参数 方法 


使 用 之 前 的 Product 类 进行 演示 ， 将 此 类 复 仍 


I 一 份 ， 定 义 一 个 方法 initMethod， 当 然 方法 


可 以 随便 定义 ， 具 体 如 下 : 


package com.javadevmap.bean; 
public class ProductWithInitMethod { 


private int id; 

private String name; 

public ProductWithInitMethod() { 

} 

public ProductWithInitMethod(int id, String name) { 
System.out.println("invoke method — Product(int id, String name)"); 
this.id = id; 
this.name = name; 

} 

// 省 略 get set 方法 

public void initMethodO { 
System.out.printIn("execute initMethod()"); 


} 
} 
之 后 在 XML 文件 的 bean 标签 中 定义 init-method 属性 ， 属 性 值 为 上 面 定 义 的 initMethod 方 
法 的 名 称 。 有 具体 如 下 : 


<?xml version="1.0" encoding="UTF-8"?> 
<beans xmins="http://www.springframework.org/schema/beans" 


xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 

xsi:schemaLocation="http://www.springframework.org/schema/beans 

http://www.springframework.org/schema/beans/spring—beans.xsd"> 

<! 一 配置 信息 一 > 

<bean id="beanld" init-method="initMethod" 
class="com.javadevmap.bean.ProductWithInitMethod"></bean> 


</beans> 
编写 测试 代码 如 下 : 
public class TestIocCaseLifeCircleWithInitMethod { 
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AbstractApplicationContext ctx; 

ProductWithInitMethod bean; 

@Test 

public void testCase() { 
ctx=new ClassPathXmlApplicationContext("spring-bean-initMethod.xml"); 
System.out.println("execute one"); 


第 5 章 Spring 
bean =(ProductWithInitMethod) ctx.getBean("beanId"); 


System.out.println("execute two"); 
bean =(ProductWithInitMethod) ctx.getBean("beanId"); 


execute initMethod() 
execute one 
execute two 


观察 运行 结果 可 以 发 现 initMethod 方法 仅仅 在 初始 化 的 时 候 调 用 一 次 ， 由 于 此 bean 标签 配 
置 的 是 单 例 模式 ， 所 以 之 后 再 次 使 用 getBean 方法 时 initMethod 方法 没有 被 调用 。 

(2) 销毁 回调 函数 ， 有 两 种 实现 方式 : 

1) 实现 org.springframework.beans.factory.DisposableBean 接口 。 
使 用 之 前 的 Product 类 进行 演示 ， 将 此 类 复制 一 份 ， 然 后 实现 DisposableBean 接口 ， 具 体 如 下 : 


package com.javadevmap.bean; 
import org.springframework.beans. factory. DisposableBean; 
public class ProductWithDisposableBean implements DisposableBean { 
private int id; 
private String name; 
public ProductWithDisposableBean() { 
j 
public ProductWithDisposableBean(int id, String name) { 
System.out.println("invoke method — Product(int id, String name)"); 
this.id = id; 
this.name = name; 


} 

// RK get 与 set 方法 

@Override 

public void destroy() throws Exception { 
System.out.println("execute destroy()"); 


} 
} 


在 Spring 配置 文件 中 配置 bean 标签 ， 有 具体 如 下 : 


<?xml version="1.0" encoding="UTF-8"?> 

<beans xmIns="http://www.springframework.org/schema/beans" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xsi:schemaLocation="http://www.springframework.org/schema/beans 
http://www.springframework.org/schema/beans/spring—beans.xsd"> 


<! 一 配置 信息 一 > 
<bean id="beanld" class="com.javadevmap.bean.ProductWithDisposableBean"></bean> 
</beans> 
为 了 能 监听 到 销毁 回调 函数 ， 需 要 在 AbstractApplicationContextS 类 中 调用 关闭 hook 


的 registerShutdownHook() 方法 。 它 将 确保 正常 关闭 Bean， 并 且 调 用 destroy 方法 。 编 写 测试 代 
码 如 下 : 


© AbstractApplicationContext 抽象 类 ，Spring 中 所 有 ApplicationContext 的 父 类 ， 实 现 了 一 些 比较 核心 的 方法 。 
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public class TestlocCaseLifeCircleWithDisposableBean { 

AbstractApplicationContext ctx; 

ProductWithDisposableBean bean; 

@Test 

public void testCase() { 
ctx=new ClassPathXmlA pplicationContext("spring—bean-disposable.xml"); 
System.out.println("execute one"); 
bean =( ProductWithDisposableBean) ctx.getBean("beanId"); 
System.out.println("execute two"); 
bean =( ProductWithDisposableBean) ctx.getBean("beanId"); 
ctx.registerShutdownHook(); 


execute one 
execute two 
execute destroy() 


观察 控制 台 输出 内 容 ， 当 对 象 被 销毁 时 会 调用 DisposableBean 接口 的 destroy0 方 法 。 
2) 在 配置 文件 中 使 用 destroy-method 属性 来 指定 无 参数 方法 。 
使 用 之 前 的 Product 类 进行 演示 ， 将 此 类 复制 一 份 ， 定 义 一 个 方法 destroyMethod， 具 体 如 下 : 
public class ProductWithDestroyMethod { 
private int id; 
private String name; 
public ProductWithDestroyMethod() { 


} 

public ProductWithDestroyMethod(int id, String name) { 
System.out.println("invoke method — Product(int id, String name)"); 
this.id = id; 
this.name = name; 


} 

// 省 略 get 与 set 方法 

public void destroyMethodO { 
System.out.printIn("execute destroyMethod()"); 


} 
} 


在 XML 配置 中 指定 bean 标签 destroy-method 属性 对 应 类 中 的 方法 名 称 : 


<?xml version="1.0" encoding="UTF-8"?> 

<beans xmIns="http://www.springframework.org/schema/beans" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xsi:schemaLocation="http://www.springframework.org/schema/beans 
http://www.springframework.org/schema/beans/spring—beans.xsd"> 
= Ketek — 
<bean id="beanId" destroy—method="destroyMethod" 

class="com.javadevmap.bean.ProductWithDestroyMethod"></bean> 


</beans> 
编写 测试 代码 如 下 : 


public class TestlocCaseLifeCircleWithDestroyMethod { 
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AbstractApplicationContext ctx; 

ProductWithDestroyMethod bean; 

@Test 

public void testCase() { 
ctx=new ClassPathXmlA pplicationContext("spring-bean-destroyMethod.xml"); 
System.out.println("execute one"); 
bean =(ProductWithDestroyMethod) ctx.getBean("beanId"); 
System.out.println("execute two"); 
bean =(ProductWithDestroyMethod) ctx.getBean("beanId"); 
ctx.registerShutdownHook(); 


} 
运行 结果 如 下 : 
execute one 


execute two 
execute destroyMethod() 


这 里 注册 了 registerShutdownHook() YE, Æ Bean 销毁 的 时 候 ， 会 执行 对 应 配置 的 销毁 


通过 上 面 的 例子 ， 将 方法 关联 到 Bean 的 生命 周期 ， 以 便 在 恰当 的 生命 周期 中 实现 业务 逻 
辑 。 例 如 在 容器 初始 化 时 预 加 载 缓存 ， 或 者 销毁 时 进行 日 志 统 计 等 。 


5.3.6 ”注解 实现 IoC 


使 用 XML 方式 实现 JoC， 每 次 增加 业务 类 都 需要 在 XML 中 配置 ， 非 常 烦琐 。 这 里 可 使 用 
注解 来 减轻 工作 量 ， 需 要 在 Spring 的 配置 文件 中 设置 开启 注解 。 从 Spring 2.5 开始 就 可 以 使 用 注 
解 来 配置 依赖 注入 ， 将 bean 的 配置 移动 到 类 本 身 。 

通过 使 用 @Repository、@Component、@Service ~ @Controller 注解 ，Spring 会 自动 创建 相 
应 的 BeanDefinition 对 象 ， 并 注册 到 ApplicationContext 中 。 使 用 这 些 注 解 的 类 就 成 了 Spring 受 
管 组 件 。 

上 面 所 说 的 四 个 注解 的 具体 使 用 场景 见 表 5-3。 


表 5-3 loC 注解 


注解 E X 
@Repository 于 标注 数据 访问 组 件 ， 即 DAO 组 件 
@Service 用 于 标注 业务 层 组 件 
@Controller 于 标注 控制 层 组 件 (类似 struts 中 的 action) 
@Component 泛 指 组 件 ， 当 组 件 不 好 归属 的 时 候 ， 可 以 使 用 这 个 标注 
当然 ， 在 业务 类 中 添加 上 面 的 注解 还 不 够 ， 还 需要 在 Spring 文件 中 配置 扫描 组 件 ， 可 以 让 


Spring 自动 发 现 含 有 注解 的 类 ， 进 行 相应 的 注入 ， 即 在 <context:component-scan> 标 签 中 配置 扫 
的 包 路 径 ， 如 果 有 多 个 可 以 用 逗号 隅 开 。 
本 项 目 注 解 的 类 都 在 com.javadevmap 包 下 面 ， 具 体 配 置 如 下 : 
<?xml version="1.0" encoding="UTF-8"?> 


<beans xmIns="http://www.springframework.org/schema/beans" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
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xmlns:p="http://www.springframework.org/schema/p" 

xmlns:context="http://www.springframework.org/schema/context" 

xsi:schemaLocation="http://www.springframework.org/schema/beans 
http://www.springframework.org/schema/beans/spring-beans.xsd 
http://www.springframework.org/schema/context 
http://www.springframework.org/schema/context/spring-context—4.3.xsd"> 


<context:component-scan base package= "com.javadevmap"> </context:component-scan> 


</beans> 


下 面 使 用 一 个 添加 商品 的 接口 类 及 其 实现 来 演示 注解 实现 的 ToC: 
public interface IProductDao { 
[** 
* 添加 商品 接 
public String addProduct(String id,String name); 


} 
ProductAnnoDaolmpl 实现 类 如 下 : 


@Repository ("productDaolmp1") 
public class ProductDaoImpl implements [ProductAnnoDao { 
public String addProduct(String id, String name) { 
String result=String.format(" 添 加 商品 id=%s， 商 品名 称 为 %s， 成 功 ! ", idname); 
return result; 


} 
编写 测试 代码 如 下 : 
public class TestAnnoCaseComponent { 
IProductDao productDao; 
ApplicationContext ctx; 
@Test 
public void testCase() { 
ctx=new ClassPathXmlA pplicationContext("spring-bean-scan.xml"); 
productDao=(IProductDao)ctx.getBean("productDaolmp1"); 
System.out.println("productDao is "+productDao); 
String result = productDao.addProduct("2", "javaDevmap anno"); 
System.out.println(result); 


productDao is com.javadevmap.dao.ProductDaoImpl@78dd667e 
添加 商品 id=2， 商 品名 称 为 javaDevmap anno， 成 功 ! 


本 例 中 通过 <context:component-scan> 标 签 配置 扫描 路 径 ， 同 时 在 扫描 路 径 里 面 的 类 中 添加 
注解 ， 就 可 以 实现 类 的 构建 ， 使 用 相 比 XML 便利 很 多 。 


© Spring 对 注解 形式 的 bean 的 名 字 默 认 处 理 就 是 将 首 字母 小 写 ， 再 拼接 后 面 的 字符 ， 当 类 的 名 字 是 以 两 个 或 两 个 以 上 的 大 写字 母 
开头 时 ，bean 的 名 字 会 与 类 名 保持 一 致 。 
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5.3.7 ”注解 的 作用 域 scope 


注解 的 作用 域 需 要 通过 使 用 @Scope 来 指定 。 功 能 与 之 前 在 <bean> 标 签 中 配置 scope 属性 一 
样 。@Scope 里 面 的 属性 值 ， 具 体 可 以 参考 <bean> 中 scope 配置 的 属性 值 。 使 用 之 前 的 商品 服务 
ProductDaoImpl2， 在 类 中 增加 Scope 注解 。 有 具体 代码 如 下 : 

@Repository("productDaoImp1") 


@Scope("prototype") 
public class ProductDaoImp! implements [ProductDao { 


public String addProduct(String id, String name) { 
String result=String.format(" 添 加 商品 id=%s， 商 品名 称 为 %s, WIJ! ", idname); 
return result; 


} 


5.3.8 ”自动 装配 

在 学 习 Spring 自动 装配 之 前 ， 需 要 弄 明 白 什 么 是 装配 。 在 Spring 中 ， 对 象 无 需 自己 查找 或 
创建 与 之 关联 的 其 他 对 象 ， 容 器 负责 把 需要 互相 调用 的 对 象 引 用 赋予 各 个 对 象 。 而 创建 对 象 之 
间 协 作 关 系 的 行为 通常 称 为 装配 。 常 用 的 装配 注解 多 表 5-4。 


表 5-4 装配 注解 


注 fe E X 
@Resource 默认 是 按照 名 称 来 装配 注入 的 ， 只 有 当 找 不 到 与 名 称 匹 配 的 Bean 才 会 按照 类 型 来 装配 注入 
@Autowired 默认 是 按照 类 型 装配 注入 的 ， 如 果 想 按照 名 称 来 装配 注入 ， 则 需要 结合 @Qualifier 一 起 使 


@Resource 和 @Autowired 均 可 在 Bean 注入 时 使 用 ，@Resource 并 不 是 Spring 的 注解 ， 它 
的 包 是 javax.annotation.Resource， 需 要 导入 ， 但 是 Spring 文 持 该 注解 的 注入 。@Resource 和 
@Autowired 都 可 以 标注 在 字段 或 者 该 字段 的 setter 方法 上 。 
下 面 以 产品 服务 ProductService 内 部 注入 IProductDao 为 例 ， 演 示 @Autowired 的 使 用 方法 : 
@Service 
public class ProductService { 
@Autowired 
[ProductDao productDaolmpl; 
public void addProduct(String id,String name) { 
System.out.printIn("execute addProduct method()"); 


String result = productDaolmpl.addProduct(id, name); 
System.out.println(result); 


T 


} 


5.3.9 @Autowired 5 @ Qualifier 


当 容 器 中 存在 多 个 Bean 实现 同一 个 接口 ， 那 么 注入 此 接口 的 地 方 仅 使 用 @Autowired， 注 
入 将 不 能 执行 ， 会 抛 出 异常 。 解 决 办 法 是 给 @Autowired 增加 一 个 候选 值 ， 在 @Autowired 后 面 


© 
7 


里 仅 作为 prototype 演示 ， 实 际 使 用 中 这 个 类 一 般 都 为 单 例 模式 。 
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增加 一 个 @Qualifier 注解 ， 提 供 一 个 String 类 型 的 值 作为 候选 的 Bean 的 名 字 。 例 如 ， 产 品 增加 
接口 针对 国内 和 国外 业务 场景 ， 有 两 个 类 实现 此 接口 ， 其 体 如 下 : 


public interface IProductDao { 
public String addProduct(String id,String name); 


} 
ProductDaoForBusiOnelmpl 实现 如 下 : 


@Repository("productDaoOne") 
public class ProductDaoForBusiOnelImpl implements [ProductDao { 
@Override 
public String addProduct(String id, String name) { 
String result = String.format(ProductDaoForBusiOnelmpl.class.getSimpleName() 
+" 添加 商品 id=%s， 商 品名 称 为 %s， 成 功 ! ", id, name); 
return result; 


} 
ProductDaoForBusiTwolmpl 实现 如 下 : 


@Repository("productDaoTwo") 
public class ProductDaoForBusiTwolmpl implements IProductDao { 
@Override 
public String addProduct(String id, String name) { 
String result = String .format(ProductDaoForBusiTwolmpl.class.getSimpleName() 
+" 添加 商品 id=%s， 商 品名 称 为 %s， 成 功 ! ", id, name); 
return result; 


} 
PL ProductServiceBoth 来 注入 以 上 P 
@Service 
public class ProductServiceBoth { 
@Autowired 


@Qualifier("productDaoOne") 
IProductDao productDao01; 


实例 ， 具 体 实 现 如 下 : 


H 
RA 

X 
将 


@Autowired 
@Qualifier("productDaoTwo") 
IProductDao productDao02; 


public void addProduct(String id,String name) { 
System.out.printIn("execute addProduct method()"); 
String result= productDao01.addProduct(id, name); 
System.out.println(result); 
result = productDao02.addProduct(id, name); 
System.out.println(result); 


} 
主意 @Qualifier 注解 里 面 的 名 称 要 与 Bean 的 注解 名 称 保持 一 致 ， 否 则 自动 装配 会 严 配 失败 。 


一 < 


如 果 在 ProductServiceBoth 中 引入 的 IProductDao 未 增加 @Qualifier 注解 ， 则 会 报告 如 下 
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Caused by: org.springframework.beans.factory.NoUniqueBeanDefinitionException: No qualifying bean of 

type [com.javadevmap.dao.IProductDao] is defined: expected single matching bean but found 3: 
productDaoOne,productDaoTwo,productDaolmpl 

at org.springframework.beans.factory.config. DependencyDescriptor.resolveNotUnique(Dependency 
Descriptor.java: 172) 

at org.springframework.beans.factory.support.DefaultListableBeanFactory.doResolveDependency 
(DefaultListableBeanFactory.java: 1106) 

at org.springframework.beans.factory.support. DefaultListableBeanFactory.resolveDependency(Default 
Listable BeanFactory.java:1056) 

at org.springframework.beans.factory.annotation. AutowiredA nnotationBeanPostProcessor$AutowiredField 
Element.inject(AutowiredAnnotationBeanPostProcessor.java:566) 

... 38 more 


Spring 根据 接口 IProductDao 查找 到 了 多 个 实现 类 ， 但 无 法 确定 该 用 哪个 ， 于 是 报告 上 面 的 
错误 。 需 要 使 用 @Qualifier 来 明确 告诉 Spring 要 使 用 哪个 实现 类 。 


5.4 Aop 


考虑 这 样 一 个 业务 场景 : 在 核心 业务 中 做 日 志 记录 ， 传 统 的 做 法 是 写 好 工具 类 ， 然 后 在 业 
务 方法 的 前 后 部 分 增加 日 志 记 录 代 码 。 还 有 一 种 做 法 是 将 核心 业务 接口 抽取 出 来 ， 在 执行 抽象 
接口 的 前 后 增加 日 志 记 录 ， 这 种 方式 更 加 高 明 。 但 是 如 果 要 做 的 业务 比较 多 ， 而 且 部 分 代码 不 
能 随意 修改 ， 这 样 的 日 志 记 录 功 能 就 很 难 完成 。 

面向 方面 编程 (AOP)， 也 可 称 为 面向 切面 编程 ， 是 一 种 编程 范式 ， 从 另 一 个 角度 来 考虑 程 
序 结 构 ， 从 而 完善 面向 对 象 编 程 COOP). 

AOP 的 诞生 就 是 为 了 解决 类 似 上 面 的 业务 问题 ， 即 定义 好 日 志 组 件 ， 日 志 组 件 横 切 业务 逻 
辑 ， 这 样 既 不 耦合 现 有 的 业务 ， 还 能 完成 需要 的 日 志 记 录 功 能 。 
5.4.1 AOP 的 核心 概念 

AOP 是 通过 预 编译 方式 和 运行 期 动态 代理 实现 程序 功能 的 统一 维护 的 一 种 技术 。AOP 是 OOP 
的 延续 ， 是 软件 开发 中 的 一 个 热点 ， 也 是 Spring 框架 中 的 重要 内 容 ， 是 函数 式 编程 的 一 种 衍生 范 
型 。 利 用 AOP 可 以 对 业务 逻辑 的 各 个 部 分 进行 隔离 ， 从 而 使 业务 逻辑 各 部 分 之 间 的 耦合 度 降 低 ， 提 
高 程序 的 可 重用 性 ， 同 时 提高 开发 效率 。AOP 相关 概念 见 表 5-5。 


表 5-5 AOP 概念 


概 念 含义 
切面 aspect) 类 是 对 物体 特征 的 抽象 ， 切 面 就 是 对 横 切 关注 点 的 抽象 
横 切 关注 点 对 哪些 方法 进行 拦截 ， 拦 截 后 怎么 处 理 ， 这 些 关 注 点 称 为 横 切 关注 点 
连接 点 Goinpoint) 被 拦截 到 的 点 
切入 点 (pointcut) 对 连接 点 进行 拦截 的 定义 
通知 (advice) 拦截 到 连接 点 之 后 要 执行 的 代码 ， 通 知 分 为 前 置 、 后 置 、 异 常 、 最 终 、 环 绕 通 知 五 类 
BAA (weave) 将 切面 应 用 到 目标 对 象 并 导致 代理 对 象 创建 的 过 程 
引入 (introduction) 在 不 修改 代码 的 前 提 下 ， 引 入 可 以 在 运行 期 为 类 动态 地 添加 一 些 方法 或 字段 
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5.4.2 AOP 的 代理 机 制 


Spring AOP 是 用 动态 代理 的 方式 实现 
的 方式 。 动 态 代理 又 分 为 JDK 动态 代理 Gil 
HE). Spring 优先 使 用 JDK 动态 代理 9 。 


a 


Java 的 代理 ?实现 分 为 静态 代理 和 动态 代理 。 


静态 代理 通常 是 对 原 有 业务 逻辑 的 扩充 ， 即 通过 代理 


类 持 有 真实 对 象 ， 然 后 在 业务 代码 


的 ， 动 态 代 理 是 在 运行 期 为 目标 类 添加 增强 生成 子 类 
过 接口 创建 代理 )，CGLib 动态 代理 (通过 类 创建 代 


调用 代理 类 的 方法 ， 而 代理 类 里 面 的 方法 才 会 调用 真实 对 象 的 方法 ， 在 不 改变 原 有 业务 代码 的 


前 提 下 ， 增 加 其 他 业务 逻辑 。 


动态 代理 ， 代 理 类 并 不 是 在 Java 代码 中 实现 ， 而 是 在 运行 期 间 生 成 ， 相 比 静 态 代理 ， 动 态 
代理 可 以 在 运行 期 间 动态 生成 一 个 持 有 真实 对 象 并 实现 代理 接口 的 Proxy， 同 时 注入 需要 的 扩展 
逻辑 。 

5.4.3 ”基于 Schema 的 AOP 使 用 
要 了 解 基于 Schema 的 AOP 方式 ， 需 要 先 了 解 配置 AOP 的 常用 标签 ， 见 表 5-6。 
表 5-6 AOP 常用 标签 
标签 含义 
<aop:advisor> 定义 一 个 AOP 通知 者 
<aop:after> 后 通知 
<aop:after-returning> 返回 后 通知 
<aop:after-throwing> 抛 出 异常 后 通知 
<aop:around> 周围 通知 
<aop:aspect> 定义 一 个 切面 
<aop:before> 前 通知 
<aop:config> 顶级 配置 元 素 ， 类 似 于 <beans> 
<aop:pointcut> 定义 一 个 切入 点 

配置 中 常用 的 通配符 的 含义 如 下 : 

m *: 中 配 任 何 数 量 字 符 。 

E: 匹配 任何 数量 字符 的 重复 ， 如 在 类 型 模式 中 匹配 任何 数量 层级 ， 在 方法 参数 模式 中 匹 

配 任何 数量 参数 。 
图 十 匹配 指定 类 型 的 子 类 型 ， 仅 能 作为 后 缀 放 在 类 型 模式 后 边 。 
这 里 通过 AOP 实现 在 调用 ProductServcie 类 中 方法 的 前 后 打印 日 志 。AOP 编程 其 实 是 很 简 


C1) 定义 普通 业务 组 件 。 


单 的 事情 ， 纵 观 AOP 编程 ， 只 需要 实现 三 个 部 分 : 


这 里 使 用 前 面 的 ProductService 业务 类 。 


(2) 定义 切入 点 ， 一 个 切入 点 可 能 横 切 多 个 业务 组 件 。 


<?xml version="1.0" encoding="UTF-8"?> 


© 默认 使 用 IDK 动态 代理 来 创建 AOP 代理 ， 可 以 为 任何 接口 实例 创建 代理 ， 当 需要 代理 的 类 不 是 代理 接 


换 为 使 用 CGLib 代理 ， 也 可 强制 使 用 CGLib。 
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的 时 候 ，Spring 会 切 


O 代理 模式 ， 为 其 他 对 象 提供 一 种 代理 以 控制 对 这 个 对 象 的 访问 。 在 某 些 情况 下 ， 一 个 对 象 不 适合 或 者 
象 ， 而 代理 对 象 可 以 在 客户 端 和 目标 对 象 之 间 起 到 中 介 的 作用 。 


` 能 直接 引 


男 一 个 对 


<beans xmIns="http://www.springframework.org/schema/beans" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xmins:p="http://www.springframework.org/schema/p" 
xmlns:aop="http://www.springframework.org/schema/aop" 
xmins:context="http://www.springframework.org/schema/context" 
xsi:schemaLocation="http://www.springframework.org/schema/beans 
http://www.springframework.org/schema/beans/spring—beans.xsd 
http://www.springframework.org/schema/context 
http://www.springframework.org/schema/context/spring-context-4.3.xsd 
http://www.springframework.org/schema/aop _http:/Avww.springframework.org/schema/aop/spring— 


—" 


By 


Spring 


com.javadevmap"></context:component-scan> 


com.javadevmap.bean.AdvicesBean"></bean> 


的 类 是 否 为 一 个 没 


gi 


则 使 用 


实现 接 


的 类 ，Spring 会 根据 当前 被 


JDK 内 置 动态 代理 ， 如 果 未 实现 接 


注入 的 精确 位 置 ) 一 > 


口 则 使 用 


execution(* com.javadevmap.service.ProductService.*(..))" 


<! 一 声明 通知 ，method 指定 通知 类 型 ，pointcut 指定 切 点 ， 就 是 通知 应 该 注入 哪些 方法 


aop-4.3.xsd"> 
<! 一 指定 要 扫描 的 包 ， 如 果 有 多 个 可 以 用 逗号 隔 开 一 > 
<context:component—scan base package 
i= = 全 
<bean id="advice" class=" 
<!— AOP MWE 二 > 
<!— proxy-target-class 属性 表示 被 代理 
代理 的 类 是 否 实现 接口 来 选择 代理 方式 。 如 果实 现 了 
CGLIB 动态 代理 一 > 
<aop:config proxy—target—class="true"> 
es Ce, = 
<!—ref 表示 通知 对 象 的 引用 一 > 
<aop:aspect ref="advice"> 
<!-- ACE) A AC 
<aop:pointcut 
expression=" 
id="pointcut1" /> 
poy Ss 


<aop:before method="before" pointcut-ref="pointcut 1" /> 


<aop:after method="after" pointcut-ref="pointcut1" /> 


<aop:around method="around" 
pointcut="execution(* com.javadevmap.service.ProductService.*(..))" /> 
<aop:after-throwing method="afterThrowing" 
pointcut="execution(* com.javadevmap.service.ProductService.*(..))" 
throwing="exp" /> 
<aop:after-returning method="afterReturning" 
pointcut="execution(* com.javadevmap.service.ProductService.*(..))" 
returning="result" /> 


</aop:aspect> 


</aop:config> 
</beans> 


3) 定义 增强 


虽 处 理 ， 


增强 处 型 


public class AdvicesBean { 


// 前 置 通 


知 


public void before(JoinPoint jp) 


{ 


System.out.println(" 


通 


知 < RISE 


Ht ed AOP 框架 为 普通 业务 组 件 织 入 的 处 理 动作 。 


System.out.println(" 方 法 名 : "+jp.getSignature().getName() 


+"， 参 数 长 度 : "+jp.getArgsO.length+"， 被 代理 


"+jp.get Target().getClass().getName()); 


EXT SE: 
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/后 置 通知 
public void after(JoinPoint jp) { 
System.out.printIn("---------- > 后 置 通知 <---------- 9): 
} 
/环绕 通知 
public Object around(ProceedingJoinPoint pjd) throws Throwable{ 
System.out.println("--------— > 环绕 开始 <---------- Mp 
Object object=pjd.proceed(); 
System.out.printIn("---------- > 环绕 结束 <---------- Mp 
return object; 
} 
// 异 常 后 通知 
public void afterThrowing(JoinPoint jp,Exception exp) 
{ 
System.out.printIn("'---------- > 异常 后 通知 ， 发 生 了 异常 : "+exp.getMessage()+"<---------- ip 
} 


/返回 结果 后 通知 
public void afterReturning(JoinPoint joinPoint, Object result) 


{ 


} 
} 


System.out.println("---------- > 返回 结果 后 通知 <---------- Mp 


System.out.println("4 4272: "+result); 


编写 测试 代码 如 下 : 
public class TestAopCase { 

ProductService proService; 

ApplicationContext ctx; 

@Test 

public void testCase() { 


方法 名 : 


ctx=new ClassPathXmlA pplicationContext("spring-bean-aop.xml"); 
/从 容器 中 获得 bean 
proService=(ProductService)ctx.getBean(ProductService.class); 
proService.addProduct("4001", "java dev map"); 


addProduct, BAKE: 2， 被 代理 对 象 : com.javadevmap.service.ProductService 


20180412 _07:59:45.028 [org.springframework.beans.factory.support.DefaultListableBeanFactory ][main] 
[DEBUG] Returning cached instance of singleton bean 'advice' 


execute addProduct method() 

添加 商品 id=4001， 商 品名 称 为 287af598-2c2d-46dce-89f6-d3f3003be2d4-java dev map， 成 功 ! 

20180412 _07:59:45.225 [org.springframework.beans.factory.support.DefaultListableBeanFactory ][main] 
[DEBUG] Returning cached instance of singleton bean 'advice' 


---------- > 返回 结果 后 通知 <---------- 


20180412 07:59:45.225 [org.springframework.beans.factory.support.DefaultListableBeanFactory ][main] 
[DEBUG] Returning cached instance of singleton bean 'advice' 
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5.4.4 基于 @AspectJ 的 AOP 使 用 
Spring 除了 支持 Schema 方式 配置 AOP， 还 文 持 注解 方式 ， 即 使 用 @Aspect 风格 的 切面 声 


明 。 为 了 支持 @AspectJ， 需 要 在 Spring 配置 文件 中 使 用 如 下 配置 : 


<aop:aspectj-autoproxy/> 


具体 使 
(1) 在 本 


流程 : 
Fer 


置 文件 中 添加 <aop:aspectj-autoproxy/> 配 置 。 


(2) 创建 Bean， 使 用 @Aspect 注解 修饰 该 类 。 
(3) 创建 方法 ， 使 用 @Before、@After、@Around 等 进行 修饰 ， 在 注解 中 写 上 切入 点 的 表 


这 里 演示 通过 AOP 注解 的 方式 实现 在 调用 ProductServcie 中 addProduct 方法 的 前 后 打印 


志 。 定 义 一 个 AspectjBean 类 ， 有 具体 如 下 : 


@A: 


spect 


public class AspectjBean { 


j 


@Pointcut("execution(* com.javadevmap.service.ProductService.*(..))") // expression 

private void businessService() { 

} 

@Before("businessService()") 

public void beforeAdvice() { 
System.out.printIn("beforeA dvice() 一 > Going to exec addProduct."); 

} 

@After("businessService()") 

public void afterAdvice() { 
System.out.println("afterAdvice() --> addProduct has been done."); 

} 

@AfterReturning(pointcut = "businessService()", returning = "retVal") 

public void afterReturningAdvice(Object retVal) { 
System.out.println("afterRetumingA dvice() —->Returning"); 

} 

@AfterThrowing(pointcut = "businessService()", throwing = "ex") 

public void AfterThrowingA dvice(IllegalArgumentException ex) { 
System.out.printIn("AfterThrowingAdvice-—> There has been an exception: " + ex.toString()); 


} 


在 Spring 配置 文件 中 增加 如 下 核心 配置 : 


<! 一 指定 要 扫描 的 包 ， 如 果 有 多 个 可 以 用 去 号 隔 开 一 > 


<context:component-scan base-package 


com.javadevmap"></context:component-scan> 


<aop:aspectj—autoproxy /> 
<!— aspect 通知 一 > 


<bean id="aspectJ" class 


com.javadevmap.service. AspectjBean"></bean> 


Wy TRA 


@Service 


s 抛 出 异常 的 通知 ， 在 ProductService 中 增加 doThrowException 方法 : 


public class ProductService { 


/省略 之 前 业务 代码 逻辑 


public void doThrowException() { 
System.out.println("Exception raised"); 
throw new IllegalArgumentException(); 
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} 
j 


编写 测试 代码 如 下 : 


public class TestAopCaseAspectJ { 

ApplicationContext ctx; 

@Test 

public void testCase() { 
ctx = new ClassPathXmlApplicationContext("spring-bean-aspectj.xml"); 
productService=(ProductService)ctx.getBean(ProductService.class); 
productService.addProduct("4001", "java dev map"); 
productService.doThrowException(); 


beforeAdvice() 一 > Going to exec addProduct. 

execute addProduct method() 

添加 商品 id=4001， 商 品名 称 为 java dev map， 成 功 ! 

afterAdvice() —> addProduct has been done. 

afterRetumingA dvice() ->Returning 

beforeAdvice() 一 > Going to exec addProduct. 

Exception raised 

afterAdvice() 一 > addProduct has been done. 

AfterThrowingAdvice-—> There has been an exception: java.lang IllegalArgumentException 


通过 前 面 的 例子 ， 可 见 在 未 修改 自己 的 业务 类 的 前 提 下 ， 利 用 Spring 的 AOP 特性 即 可 在 方 
法 的 前 后 增加 一 些 其 他 业务 逻辑 。 


5.5 集成 Logback 


Logback 是 一 个 开源 的 日 志 组 件 ， 本 节 将 介绍 在 Spring 工程 中 集成 Logback 实现 日 志 打印 
的 方法 。 


5.5.1 SLF4J 简介 


SLF4J (Simple Logging Facade For Java) 是 一 个 针对 各 类 Java 日 志 框 架 的 统一 抽象 。Java 
志 框 架 众 多 ， 常 用 的 有 java.util.logging、log4j、logback、commons-logging。Spring 框架 使 用 
的 是 Jakarta Commons Logging API (JCL)。 在 使 用 SLF4J 的 时 候 ， 不 需要 在 代码 或 配置 文件 中 
指定 打算 使 用 哪个 具体 的 日 志 系 统 。SLF4J 提供 了 统一 的 记录 日 志 的 接口 ， 只 要 按照 其 提供 的 方 
法 记录 即 可 ， 最 终日 志 的 格式 、 记 录 级 别 、 输 出 方式 等 通过 具体 日 志 系统 的 配置 来 实现 ， 因 此 
可 以 在 应 用 中 灵活 切换 日 志 系 统 。 


5.5.2 Logback 概述 
LogbackS 是 一 个 开源 日 志 组 件 。Logback 当前 分 成 三 个 模块 : logback-core、logback-classic 


© Logback 官网 是 http://logback.qos.ch。 
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和 logback-accesso logback-core 是 其 他 两 个 模块 的 基础 模块 。logback-classic 是 log4j 的 一 个 改 
良 版 本 。 此 外 logback-classic 完整 实现 了 SLF4J API， 可 以 很 方便 地 更 换 成 其 他 日 志 系 统 ， 例 如 
log4j。logback-access 访问 模块 与 Servlet 容器 集成 ， 提 供 了 通过 http 来 访问 日 志 的 功能 。 


Logback 包含 的 配置 内 容 具 体 如 下 : 
(1) logger, appender 及 layout 


logger 是 日 志 的 记录 器 ， 把 它 关 联 到 应 用 的 对 应 的 context 上 后 ， 主 要 用 于 存放 日 志 对 象 ， 


也 可 以 定义 日 志 类 型 、 级 别 。 


appender 主要 用 于 指定 日 志 输 出 的 目的 地 ， 目 的 地 可 以 是 控制 台 、 文 件 、MySQL、Oracle 


和 其 他 数据 库 等 。 
layout 负责 把 事件 转换 成 字符 串 ， 格 式 化 日 志 信 息 的 输出 。 
(2) loggerContext 


各 个 logger 都 被 关联 到 一 个 LoggerContext，LoggerContext 负责 制造 logger， 也 负责 以 树 结 


构 排列 各 logger。 
(3) 有 效 级 别 及 级 别 的 继承 


mT 


logger 可 以 被 分 配 级 别 。 级 别 有 : TRACE, DEBUG, INFO, WARN 和 ERROR. WR 
logger 没有 被 分 配 级 别 ， 那 么 它 将 从 被 分 配 级 别 的 最 近 的 祖先 那里 继承 级 别 。root logger 默认 级 


别 是 DEBUG。 
(4) 打印 方法 与 基本 的 选择 规则 


打印 方法 决定 了 记录 请 求 的 级 别 。 级 别 排序 为 : TRACE < DEBUG < INFO < WARN < 


ERROR 。 


5.5.3 Logback 的 集成 


下 面 将 Logback 集成 到 Spring 项 目 中 来 ， 实 现 让 Logback 用 一 个 回 


th 


— 


台 的 功能 。 
(1) 添加 依赖 
在 pom 文件 中 添加 如 下 依赖 : 


<dependency> 
<groupld>ch.qos.logback</groupld> 
<artifactId>logback-classic</artifactId> 
<version>1.2.3</version> 

</dependency> 

<dependency> 
<groupld>ch.qos.logback</groupld> 
<artifactId>logback-core</artifactId> 
<version>1.2.3</version> 

</dependency> 

<dependency> 
<groupId>org.logback-extensions</groupId> 
<artifactId>logback-ext-spring</artifactId> 
<version>0.1.4</version> 

</dependency> 

<dependency> 
<groupld>org.slf4j</groupId> 
<artifactId>slf4j-api</artifactId> 


定格 式 将 日 志 输 出 到 控 
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<version>1.7.25</version> 
</dependency> 
<dependency> 
<groupld>org.slf4j</groupId> 
<artifactld>jcl-over-slf4j</artifactld> 
<version>1.7.25</version> 
</dependency> 


(2) 添加 配置 文件 logback.xml 

Logback 配置 文件 的 基本 结构 : 以 <configuration> 开 头 ， 后 面 有 零 个 或 多 个 <appender> 元 
素 ， 有 和 零 个 或 多 个 <logger> 元 素 ， 有 最 多 一 个 <root> 元 素 。 
在 resources 目录 新 建 一 个 名 为 logback.xml 的 文件 。 定 义 logback 的 日 志 输 出 格式 为 :“ 日 
期 线程 名 HERI 日 志 消 息 内 容 ” 文件 具体 内 容 如 下 : 


<?xml version="1.0" encoding="UTF-8"?> 
<configuration> 
<! 一 格式 化 输出 : %d 表示 日 期 ，%thread 表示 线程 名 ，%level: 日 志 级 别 ，%msg: 日 志 消 
fk, Yon 是 换行 符 一 > 
<property name="consoleLayoutPattern" 
value="%-20(%d{yyyyMMdd HH:mm:ss.SSS} [%logger][Yothread]) [%level] Yomsg%n" /> 
<! 一 控制 台 输 出 一 > 
<appender name="CONSOLE" class="ch.qos.logback.core.ConsoleAppender"> 
<layout name="StandardFormat" class="ch.qos.logback.classic.PatternLayout"> 
<pattern>$ {consoleLayoutPattern}</pattern> 
</layout> 
</appender> 


my 


<root level="DEBUG"> 
<appender-ref ref="CONSOLE" /> <!-- 控制 台 输 出 一 > 
</root> 
</configuration> 


可 根据 业务 需求 打印 不 同 级 别 的 日 志 信息 ， 下 面 简单 说 明 如 何 使 用 ; 
public class TestLog4jCase { 
private Logger logger = LoggerFactory.getLogger(TestLog4jCase.class); 
ApplicationContext context=null; 
@Test 
public void testCase() { 
context = new ClassPathXmlApplicationContext("spring-bean.xml"); 
logger.debug("debug"); 
logger.info("test"); 
logger.warn("warn"); 
logger.error("error"); 


} 

运行 结果 如 下 : 
20180410_15:25:34.450 
20180410_15:25:34.450 


20180410_15:25:34.450 
20180410_15:25:34.450 


com.javadevmap.logback.SpringLogbackApp] 
com.javadevmap.logback.SpringLogbackApp] 
com.javadevmap.logback.SpringLogbackApp] 
com.javadevmap.logback.SpringLogbackApp] 


main] [DEBUG] debug 
main] [INFO] test 
main] [WARN] warn 
main] [ERROR] error 


一 一 一 一 
Pt 
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通 
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在 实际 业务 中 ， 不 仅 要 在 控制 台 输出 
SLAR 
日 志 信 息 的 同 
日 志 信 息 记 录 的 


问题 可 


NZ 


策略 ， 才 能 在 日 
基于 这 些 前 提 ， 下 
ERROR 级 别 ， 单 个 
Æ] 


过 上 面 的 步 


以 根据 日 
然 记 录 


， 轻 松 实现 了 Spring 集成 Logback 框架 
输出 日 志 到 文件 


LAN 


只 | 因 | 。 


Hid, 


也 要 保存 日 志 信息 到 文件 ， 


以 便 日 


第 5 章 Spring 


后 系统 出 现 


时 ， 


上 一 节 项 


的 基础 


同时 让 
面 配 置 Logback 文 
日 志文 件 的 大 小 控制 在 10MB， 


DRH 
-e 


40 


ars 


日 志文 件 大 小 以 及 如 何 存放 ， 
文件 大 小 保持 在 可 控 范围 


内 。 


需要 制定 日 


志文 件 存 储 


+, ik 


日 的 


隔 


<?xml version="1.0" encoding="UTF-8"?> 

<configuration> 
<property name="SYS_LOG_DIR" value="d:/logbackDir" /> 
<property name="LOG_FILE" value="app.log" /> 


<|— 


格式 化 输出 : 


息 ，%n 是 换行 符 一 > 


%d 表示 


日 


HH, Ythread 表示 线程 名 ， 


<property name="fileLayoutPattern" value= 
"%-20(Y%d{yyyyMMdd_HH:mm:ss.SSS} [Yologger{ 10} ][Yothread]) [%level] Ymsg%n" /> 


<property name= 


consoleLayoutPattern" 


志 信 Aid 录 到 文 
H 志文 件 


上 ， 修 改 logback.xml 配置 文件 ， 具 体 如 下 : 


F, 并 | H Fr 
打 成 zip 包 按 


%level : 


由 记录 的 


志 级 别 ， 


日 志 级 别 在 
期 命名 。 


Ymsg: 


value="%-20(%d{yyyyMMdd_HH:mm:ss.SSS} [Yologger]|%thread]) [%level] Yomsg%n" /> 


<appender name="LOG_ ROLLING" 


class="ch.qos.logback.core.rolling.RollingFileAppender"> 


<file>${SYS_LOG_DIR}/${LOG_FILE}</file> 


<filter class="ch.qos.logback.classic. filter. ThresholdFilter"> 


<level>ERROR</level> 


</filter> 


<rollingPolicy class="ch.qos.logback.core.rolling. TimeBasedRollingPolicy"> 
<fileNamePattern> 
${SYS_LOG_DIR}/%d{yyyy-MM-dd}/${LOG_FILE} %d{yyyy MM-dd} %i.zip 
</fileNamePattern> 
<maxHistory>7</maxHistory> 
<timeBasedFileNamingAndTriggeringPolicy 
class="ch.qos.logback.core.rolling.SizeAndTimeBasedFNATP"> 
<maxFileSize>10MB</maxFileSize> 
</timeBasedFileNamingA ndTriggeringPolicy> 


</rollingPolicy> 
<layout> 


<pattern>$ {fileLayoutPattern}</pattern> 


</layout> 


</appender> 


<|— 


空 制 台 输出 一 > 


<appender name="CONSOLE" class="ch.qos.logback.core.ConsoleAppender"> 


<layout name="StandardFormat" class="ch.qos.logback.classic.PatternLayout"> 


<pattern>$ {consoleLayoutPattern}</pattern> 


</layout> 


</appender> 
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<root level="DEBUG"> 
<appender-ref ref=""CONSOLE" /> <!— 控制 台 输出 一 > 
<appender-ref ref="LOG_ROLLING" /> <! 一 文件 输出 一 > 
</root> 
</configuration> 


这 里 为 了 演示 日 志 存 放 的 效果 ， 临 时 将 单个 日 志 大 小 设置 为 1MB， 测 试 代码 如 下 : 


public class SpringLogbackAppFile { 
private static final Logger logger = LoggerFactory.getLogger(SpringLogbackAppFile.class); 
static ApplicationContext context = null; 
public static void main(String[] args) { 
// ToC 获取 beans 的 上 下 文 
context = new ClassPathXmlApplicationContext("spring—bean.xml"); 
for (int i= 0; i < 20000; i++) { 
logger.debug("debug" + 1); 
logger.info("test"); 
logger.warn("warn " + i); 
logger.error("error " + i); 


} 
} 
} 
运行 效果 如 图 5-1 和 图 5-2 所 示 。 


电脑 ， 本 地 磁盘 (Dj > logbackDir 
~ ia > 本 地 磁盘 (D:) > logbackDir > 2018-04-10 > 


名 称 


2018-04-10 


@ app.log 


图 5-1 日 志 运 行 效 果 图 5-2 日 志文 件 打包 效果 


志保 存 等 功能 。 


5.6 集成 MyBatis 
MyBatis 是 一 球 优 秀 的 持久 层 框 架 ， 它 支持 定制 化 SQL、 存 储 过 程 以 及 高 级 映射 。 


由 输出 可 见 ， 本 例 实现 了 指定 日 志 位 置 、 设 置 日 志 的 级 别 、 控 制 单个 日 志文 件 大 小 、 隔 天 


MyBatis 


和 的 XML 


避免 了 几乎 所 有 的 JDBC 代码 和 手动 设置 参数 以 及 获取 结果 集 。MyBatis 可 以 使 用 简 和 


或 注解 来 配置 和 映射 原生 信息 ， 将 接口 和 Java 的 POJOs 映射 成 数据 库 中 的 记录 


MYyBatis- 


Spring?, FL MyBatis 代码 无 颖 整合 到 Spring Po ARI mapper 需要 由 Spring 进行 管理 。 


5.6.1 数据 准备 


下 面 用 MyBatis 实现 一 个 针对 MySQL 数据 库 中 单 表 的 增删 改 查 功能 。 先 准备 好 测试 环境 ， 


本 节 数 据 库 采用 MySQL. MySQL 的 安装 将 在 第 19 章 介 绍 。 在 MySQL 中 创建 


个 名 为 


javadevmap 的 数据 库 ， 创 建 一 个 product 表 。 里 面 有 id, product name, product desc 和 price 四 


个 字段 。 具 体 SQL 语句 如 下 : 


CREATE DATABASE ‘javadevmap’ DEFAULT CHARACTER SET utf8 COLLATE utf8 general ci; 


© Mybatis-Spring 的 官网 是 http:/www.mybatis.org/spring/zh/index.html。 
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DROP TABLE IF EXISTS ‘product’; 
CREATE TABLE ‘product’ ( 
‘id’ int(11) NOT NULL AUTO INCREMENT, 


‘product name varchar(150) COLLATE utf8_unicode_ci DEFAULT NULL, 


‘price’ int(11) DEFAULT NULL, 


‘product_desc* varchar(500) COLLATE utf8 unicode ci DEFAULT NULL, 


PRIMARY KEY (‘id’) 


AE 


) ENGINE=InnoDB AUTO_INCREMENT=3 DEFAULT CHARSET=utf8 COLLATE=utf8_unicode_ci; 
在 MySQL 客户 端 执 行 上 述 SQL 语句 ， 就 能 生成 数据 库 以 及 对 应 的 表 。 


5.6.2 ”添加 Spring 与 Mybatis 集成 相关 依赖 
在 pom 文件 中 添加 如 下 依赖 ， 其 中 使 用 druid9 作 为 数据 库 连 接 池 


<dependencies> 

<!— 添加 spring-jdbc 包 —> 

<dependency> 
<groupld>org.springframework</groupId> 
<artifactld>spring—jdbe</artifactld> 
<version>4.3.3.RELEASE</version> 

</dependency> 

<!— 添加 mybatis 的 核心 包 一 > 

<dependency> 
<groupld>org.mybatis</groupId> 
<artifactld>mybatis</artifactld> 
<version>3.2.8</version> 


</dependency> 
<!— 添加 mybatis 与 Spring 整合 的 核心 包 -> 
<dependency> 


<groupld>org.mybatis</groupId> 
<artifactld>mybatis-spring</artifactld> 
<version>1.2.2</version> 
</dependency> 
<!— 添加 mysql 驱动 包 一 > 
<dependency> 
<groupId>mysql</groupId> 
<artifactId>mysql-connector-java</artifactId> 
<version>5.1.34</version> 
</dependency> 
<! 一 添加 druid 连接 池 包 一 > 
<dependency> 
<groupld>com.alibaba</groupId> 
<artifactId>druid</artifactld> 
<version>1.0.29</version> 
</dependency> 
dependencies> 


5.6.3 ”编写 相关 配置 文件 
在 src/main/resources 目录 下 创建 三 个 Spring 与 MyBatis 整合 的 本 


© druid 是 目前 比较 优秀 的 数据 库 连 接 池 ， 在 功能 、 性 能 、 扩 展 性 方面 表现 良好 。 


o 


| at 


L 


文件 。 这 三 个 文人 
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是 dbconfig.properties、spring-mybatis-base.xml 和 spring-mybatis.xml。 
(1) 配置 数据 库 dbconfig.properties 
基于 Spring 开发 应 用 的 时 候 , 一 般 会 将 数据 库 的 配置 放置 在 properties 文件 中 ， 
dbconfig.properties 文件 用 来 存放 数据 库 相 关 的 链接 以 及 账号 信息 。 具 体内 容 如 下 : 
driverClassName=com.mysql.jdbc.Driver 
validationQuery=SELECT 1 
jdbc_url=jdbe:mysql://localhost:3306/javadevmap_db?useUnicode=true&characterEncoding=UT F-— 
8&zeroDateTimeBehavior=convertToNull 


jdbc_username=root 
jdbc_password=root 


(2) 配置 扫 
spring-mybatis-base.xml 配置 了 数据 库 相 关 配 置 文件 以 及 扫描 包 的 路 径 。 内 容 如 下 : 


<?xml version="1.0" encoding="UTF-8"?> 
<beans 


<!— 引入 dbconfig.properties 属性 文件 一 > 

<context:property—placeholder location="classpath:dbconfig.properties" /> 

<context:component-scan base-package="com.javadevmap.mybatis" /> 
</beans> 


(3) 配置 数据 源 
spring-mybatis.xml 配置 了 数据 源 连 接 属性 、sqlSessionFactory、 扫 描 器 。 内 容 如 下 : 


<?xml version="1.0" encoding="UTF-8"?> 

<beans xmlns="http://www.springframework.org/schema/beans" xmlns:xsi="http://www.w3.org/2001/XML Schema- 
instance" xmins:tx="http://www.springframework.org/schema/tx" xmlns:aop="http://www.springframe work.org/schema/ 
aop" xsi:schemaLocation=" 

http://www.springframework.org/schema/beans 

http://www.springframework.org/schema/beans/spring-beans-3.0.xsd 

http://www.springframework.org/schema/tx 

http://www.springframework.org/schema/tx/spring-tx—3.0.xsd 

http://www.springframework.org/schema/aop 

http://www.springframework.org/schema/aop/spring—aop-3.0.xsd 

ss 


<I 配置 数据 源 一 > 

<! 一 配置 数据 源 ， 使 用 的 是 alibaba 的 Druid 一 > 

<bean name="dataSource" class="com.alibaba.druid.pool.DruidDataSource" init-method="init" destroy— 
method="close"> 


<property name="url" value="$ {jdbc_url}" /> 

<property name="username" value="$ {jdbc_username}" /> 
<property name="password" value="$ {jdbc_password}" /> 
<! 一 初始 化 连接 大 小 一 > 

<property name="initialSize" value="0" /> 

<! 一 连接 池 最 大 使 用 连接 数量 一 > 

<property name="maxActive" value="20" /> 

<! 一 连接 池 最 大 空 闪 一 > 

<property name="maxldle" value="20" /> 

<! 一 连接 池 最 小 空闲 一 > 

<property name="minIdle" value="0" /> 
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<! 一 获取 连接 最 大 等 待 时 间 一 > 

<property name="max Wait" value="60000" /> 

<property name="validationQuery" value="$ {validationQuery}" /> 
<property name="testOnBorrow" value="false" /> 

<property name="testOnReturn" value="false" /> 

<property name="testWhileldle" value="true" /> 


AE 


5 Spring 


<! 一 配置 间隔 多 和 久 才 进 行 一 次 检测 ， 检 测 需 要 关闭 的 空闲 连接 ， 单 位 是 毫秒 一 > 


<property name="timeBetweenEvictionRunsMillis" value="60000" /> 
< 配置 一 个 连接 在 池 中 最 小 生存 的 时 间 ， 单 位 是 毫秒 一 > 
<property name="minEvictableldleTimeMillis" value="25200000" /> 
<! 一 监控 数据 库 一 > 
<!— <property name="filters" value="stat" /> 一 > 
<property name="filters" value="mergeStat" /> 

</bean> 


< 一 一 一 一 一 针 对 myBatis 的 配置 项 > 
<!— 配置 sqlSessionFactory 一 > 


1 


<bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean"> 
<!— 实例 化 sqlSessionFactory 时 需要 使 用 上 述 配 置 好 的 数据 源 以 及 SQL 映射 文件 一 > 


<property name="dataSource" ref="dataSource" /> 
<property name="mapperLocations"> 
<array> 
<value>classpath:mappers/*.xml</value> 
<value>classpath:mappers/manul/*.xml</value> 
</array> 
</property> 
</bean> 


<!— 配置 扫描 器 一 > 


<bean class="org.mybatis.spring.mapper.MapperScannerConfigurer"> 


<! 一 扫描 com.javadevmap.mybatis.dao 这 个 包 以 及 它 的 子 包 下 的 所 有 了 映射 接口 类 一 > 


<property name="basePackage" value="com.javadevmap.mybatis.dao" /> 


<property name="sqlSessionFactoryBeanName" value="sqlSessionFactory" /> 


</bean> 


<! 一 配置 Spring 的 事务 管理 器 一 > 
<bean id="transactionManager" 


class="org.springframework.jdbc.datasource. DataSourceTransactionManager"> 


<property name="dataSource" ref="dataSource" /> 
</bean> 
</beans> 


o 


径 下 搜索 的 ， 这 个 根 路 径 是 个 逻辑 路 径 ， 并 不 是 磁盘 路 径 。 
5.6.4 TEH generator 生成 单 表 增删 改 查 代码 


配置 sqlSessionFactory 的 时 候 ，mapperLocations 属性 值 配 置 在 resources 里 面 的 mapper 文件 
夹 中 。 注 意 路 径 前 级 的 classpath。classpath 本 质 是 JVM 的 根 路 径 ，JVM 获取 资源 都 是 从 该 根 路 


MyBatis Generator 是 一 个 MyBatis 的 代码 生成 器 ， 可 以 根据 数据 库 中 表 的 设计 生成 对 应 的 


my 


实体 类 、XML Mapper 文 伯 
储 过 程 ， 仍 需 手 写 SQL 和 对 象 。 


本 节 主 要 介绍 基于 Maven plugin 方式 实现 代码 生成 。 生 成 代码 遵循 以 下 操作 步骤 : 配置 


H Æ 


、 接 口 ， 从 而 实现 简单 数据 库 操作 能 力 ， 但 是 如 果 需 要 


联合 查询 和 存 
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generatorMybatisCode.xml 文件 ， 在 pom.xml 文件 


执行 生成 代码 的 Maven 命令 。 
(1) 配置 generatorMybatisCode.xml 文件 


要 填写 连接 数据 库 的 配置 和 生成 的 文件 


体内 容 如 下 : 


<?xml version="1.0" encoding="UTF-8"?> 
<!DOCTYPE generatorConfiguration PUBLIC "~//mybatis.org//DTD MyBatis Generator Configuration 

1.0//EN" "http://mybatis.org/dtd/mybatis-generator-config_1_0.dtd"> 
<generatorConfiguration> 


5.1.17 jar" > 
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<I 数据 库 驱 动 包 位 置 一 > 
<classPathEntry 
location="C:\Users\Administrator\gitJavaDeveloperMap\SpringBasic\libsNeed\mysql-connector-java~ 


<context id="DB2Tables" targetRuntime="MyBatis3"> 


<commentGenerator> 

<property name="suppressAllComments" value="true" /> 
</commentGenerator> 
<! 一 数据 库 链 接 URL、 用 户 名 、 密 码 一 > 


<jdbcConnection driverClass="com.mysql.jdbc.Driver" 


—" 


connectionURL="jdbe:mysql://localhost:3306/javadevmap" 


userld="root" 
password="root"> 

</jdbcConnection> 

<javaTypeResolver> 
<property name="forceBigDecimals" value="false" /> 

</javaTypeResolver> 

<! 一 生成 实体 类 的 包 名 和 位 置 一 > 

<javaModelGenerator targetPackage="com.javadevmap.mybatis.domain" 
targetProject="C:\Users\Administrator\git\JavaDeveloperMap\SpringBasic\target\"> 
<property name="enableSubPackages" value="true" /> 


<property name="trimStrings" value="true" /> 

</javaModelGenerator> 

<! 一 生成 的 SQL 映射 文件 包 名 和 位 置 -> 

<sqlMapGenerator targetPackage="com.javadevmap.mybatis.mapping" 
targetProject="C:\Users\Administrator\git\JavaDeveloperMap\SpringBasic\target\"> 
<property name="enableSubPackages" value="true" /> 


</sqlMapGenerator> 

<! 一 ER DAO 的 包 名 和 位 置 -> 

<javaClientGenerator type=""XMLMAPPER" 
targetPackage="com.javadevmap.mybatis.dao" 
targetProject="C:\Users\Administrator\git\JavaDeveloperMap\SpringBasic\target\"> 
<property name="enableSubPackages" value="true" /> 

</javaClientGenerator> 

<!— 要 生成 哪些 表 (更 改 tableName 和 domainObjectName 就 可 以 ) 一 > 

<table tableName="product" domainObjectName="ProductBean" 


enableCountByExample="false" enableUpdateByExample="false" 


中 添加 mybatis-generator-maven-plugin 插 伯 


配置 信息 以 及 要 生成 的 实体 类 所 对 应 的 表 或 视图 。 
src/main/resources 文件 夹 下 面 创建 一 个 mybatis 文件 来 ， 创 建 一 个 generatorMybatisCode.xml 文人 


’ 


TT 


在 
H 


F 
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enableDeleteByExample="false" enableSelectByExample="false" 
selectByExampleQueryld="false" /> 
</context> 
</generatorConfiguration> 


(2) 添加 mybatis-generator-maven-plugin 插件 
在 pom.xml 中 添加 依赖 以 及 指定 前 面 自 定义 的 generatorMybatisCode.xml 文件 路 径 。 有 具体 
如 下 : 


<build> 
<plugins> 
<plugin> 
<groupld>org.mybatis.generator</groupId> 
<artifactId>mybatis—generator-maven-plugin</artifactld> 
<version>1.3.5</version> 
<configuration> 
<! 一 在 控制 台 打 印 执行 日 志 > 
<verbose>true</verbose> 
<! 一 重复 生成 时 会 覆盖 之 前 的 文件 
<overwrite>true</overwrite> 
<configurationFile>src\main\resources\mybatis\genratorM ybatisCode.xml</configurationFile> 
</configuration> 
</plugin> 
</plugins> 
</build> 
(3) 执行 Maven 生成 命令 
配置 完 上 面 的 插件 后 ， 在 工程 上 执行 “鼠标 右键 单 击 ->run as>Maven build.…”， 在 弹出 窗 
的 Goals 输入 框 中 输入 “mybatis-generator:generate”， 就 会 在 target 文件 夹 中 生成 对 应 的 文 
F， 复 制 生成 的 文件 到 对 应 的 包 路 径 下 面 即 可 。 
现在 已 经 完成 product 表 的 增删 改 查 工具 类 的 生成 ， 接 下 来 使 用 生成 的 代码 对 数据 库 进 行 基 
本 操作 ， 具 体 测试 代码 如 下 : 
@RunWith(SpringJUnit4ClassRunner.class) 
@ContextConfiguration(locations = { "classpath:spring—mybatis—base.xml", "classpath:spring—mybatis.xml" }) 
public class SpringTest { 
MW YEA 
@Autowired 
private ProductBeanMapper productBeanMapper; 


$ 
| 
V 


| 下 


@tTest 
public void insert() { 
ProductBean record=new ProductBean(); 
record.setPrice(99); 
record.setProductName("java dev map"); 
record.setProductDesc(" 产 品 描述 ， 产 品 描述 "); 
int affectsNums = productBeanMapper.insert(record); 
System.out.printIn("insert affects row num is "+affectsNums); 
} 
Test 
public void selectByPrimaryKey() { 
int id=100; 
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ProductBean bean = productBeanMapper.selectByPrimaryKey(id); 
System.out.println(bean.getIdO +" "); 
System.out.println(bean.getProductName() +" "); 
System.out.printIn(bean.getProductDesc() +" "); 
System.out.println(bean.getPrice() +" "); 
} 
@Test 
public void updateByPrimaryKeySelective() { 
ProductBean record=new ProductBean(); 
record.setId(100); 
record.setPrice(80); 
record.setProductName("java dev map —update"); 
int affectsNums = productBeanMapper.updateByPrimaryKey(record); 
System.out.printIn("updateByPrimaryKeySelective affects row num is "+affectsNums); 
} 
@Test 
public void deleteByPrimaryKey() { 
int affectsNums = productBeanMapper.deleteByPrimaryKey(1); 
System.out.printIn("deleteByPrimary Key affects row num is "+affectsNums); 


} 
通过 上 面 的 三 步 ， 可 轻松 生成 单 表 的 增删 改 查 的 相关 类 以 及 mapper 文件 ， 节 省 了 大 量 编写 
SQL 语句 的 时 间 ， 大 大 提升 了 工作 效率 。 
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第 6 六 Spring MVC 


Spring MVC 是 传统 框架 SSM 的 组 成 部 分 ， 本 章 将 介绍 Spring MVC 框架 的 特性 以 及 此 框架 
在 工程 中 的 作用 和 用 法 。 


6.1 Spring MVC 概述 


Spring MVC 是 一 种 基于 请 求 驱动 类 型 的 轻 量 级 Web 框架 ， 根 据 MVC 架构 模式 的 思想 ， 将 
Web 层 进 行 职责 解 灰 ， 基 于 请 求 驱动 〈 使 用 请 求 一 响应 模型 )， 简 化 开发 ， 同 时 Spring MVC 分 
离 了 控制 器 、 模 型 对 象 、 过 滤器 以 及 处 理 程序 对 象 的 角色 ， 这 种 分 离 让 它们 更 容易 进行 定制 。 


6.1.1 MVC 


MVC 是 一 种 设计 模式 ， 它 强制 性 地 把 应 用 程序 的 数据 展示 、 数 据 处 理 和 流程 控制 分 开 。 
MVC 将 应 用 程序 分 成 3 个 核心 模块 : 模型、 视图 、 控 制 器 。 它 们 相互 联接 又 分 别 担当 不 同 的 职 
责 ， 如 图 6-1 所 示 。 


控制 器 Servlet 
接受 用 户 请 求 、 


调用 模型 响应 用 户 请 求 、 
选择 视图 显示 响应 结果 
Request 4. 选择 视图 ， 展 示 模型 模型 JavaBean 
状态 改变 (一 般 是 业务 逻辑 ) 
增删 改 查 等 操作 
| 
3， 数 据 持久 化 查询 
视图 JSP Gee 
展示 模型 数据 、 
提供 人 机 交互 界面 数据 库 
图 6-1 MVC 模块 


E 模型 : 数据 模型 ， 提 供 要 展示 的 数据 ， 可 认为 是 Bean， 一 个 模型 可 为 多 个 视图 提供 数据 。 

m 视图 : 负责 模型 的 展示 ， 一 般 指 用户 界 面 。 

m 控制 器 : 控制 器 负责 应 用 的 流程 控制 ， 所 谓 流 程控 制 就 是 接受 用 户 请 求 ， 委 托 给 模型 进 
行 处 理 ， 获 取 模 型 数据 交 由 视图 处 理 。 


6.1.2 HTTP 请 求 处 理 流程 
在 学 习 Spring MVC 之 前 ， 需 要 了 解 网 络 请 求 的 原理 


o 
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通过 浏览 器 输入 网 址 来 访问 服务 器 ， 例 如 访问 百度 ， 在 浏览 器 中 输入 www.baidu.com， 浏 
览 器 就 会 显示 百度 的 首页 。 那 么 整个 过 程 执行 了 怎样 的 操作 呢 ? HTTP 请 求 和 响应 流程 如 下 : 

C1) 域名 解析 ， 例 如 解析 www.baidu.com。 

(2) 发 起 TCP 的 3 次 握手 。 

(3) 建立 TCP 连接 后 发 起 HTTP 请 求 。 

(4) 服务 器 端 响 应 HTTP 请求， 浏览 器 得 到 html 代码 。 

(5) 浏览 器 解析 html 代码 ， 并 请 求 html 代码 中 的 资源 。 

(6) 浏览 器 对 页 面 进行 泻 染 ， 呈 现 给 用 户 。 

以 上 是 HTTP 请 求 和 响应 的 流程 。 那 么 服务 器 是 怎么 处 理 的 呢 ? 处 理 请 求 和 发 送 响应 的 过 程 是 
由 一 种 叫 作 Servlet 的 程序 来 完成 的 ，Servlet 是 为 了 实现 动态 页 面 而 衍生 出 来 的 。 


6.1.3 Servlet 与 Tomcat 的 关系 


Java Servlet 是 运行 在 Web 服务 器 或 应 用 服务 器 上 的 程序 ， 它 是 Web 浏览 器 或 其 他 ATTP 
请 求 的 客户 端 和 HTTP 服务 器 上 的 数据 库 或 应 用 程序 之 间 的 中 间 层 。 
使 用 Servlet， 可 以 收集 来 自 网 页 表单 的 用 户 输入 ， 将 数据 库 或 者 其 他 数据 源 的 记录 展示 给 
用 户 ， 还 可 以 动态 创建 网 页 。 

Tomcat 是 Web 应 用 服务 器 ， 也 是 常用 的 一 个 Servlet 容器 。Tomcat 作为 Servlet 容器 ， 负 责 
处 理 客户 端 请 求 ， 把 请 求 传送 给 Servlet， 并 将 Servlet 的 响应 传送 回 给 客户 端 。 而 Servlet 是 一 种 
运行 在 支持 Java 语言 的 服务 器 上 的 组 件 。 Servlet 最 常见 的 用 途 是 扩展 Java Web 服务 器 功能 ， 
提供 非常 安全 的 、 可 移植 的 、 易 于 使 用 的 CGO m 

Servlet 与 Tomcat 的 关系 如 图 6-2 所 示 。 


Web 服 务 器 


Tomcat 


HTTP 请 求 ServletResponse 
一 一 
Servlet 容 器 Servlet 实 例 


-一 


HTTP 响 应 


ServletResponse 


图 6-2 Servlet 与 Tomcat 的 关系 


6.1.4 Spring MVC 的 执行 流程 

Spring MVC 是 基于 请 求 驱动 的 Web 框架 ， 并 且 也 使 用 了 前 端 控 制 器 模式 。 来 进行 设计 ， 再 
恨 据 请 求 映射 规则 分 发 给 相应 的 页 面 控制 器 《动作 /处 理 器 进行 处 理 。 

Spring MVC 的 执行 步骤 如 下 : 

(1) Spring MVC 将 所 有 的 请 求 都 提交 给 DispatcherServlet， 它 会 委托 应 用 系统 的 其 他 模块 


a 


© CGI 是 Web 服务 器 运行 时 外 部 程序 的 规范 ， 按 CGI 编写 的 程序 可 以 扩展 服务 器 功能 。 
O 前 端 控制 器 模式 提供 了 一 个 集中 的 请 求 处 理 机 制 ， 所 有 的 请 求 都 将 由 一 个 单一 的 处 理 程序 处 理 。 该 处 理 程序 可 以 做 认证 /授权 / 
记录 日 志 ， 或 者 跟踪 请 求 ， 然 后 把 请 求 传 给 相应 的 处 理 程序 。 
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负责 对 请 求 进行 真正 的 处 理工 作 。 


FE = 


3 6% Spring MVC 


(2) DispatcherServlet 查询 一 个 或 多 个 HandlerMapping， 找 到 处 理 请 求 的 Controller. 


(3) DispatcherServlet 把 请 求 提交 到 
(4) Controller 进行 业务 逻辑 处 理 后 ， 会 返 


(5) Dispathcher 查询 一 个 或 多 个 ViewResolver 视图 


的 视图 对 象 。 
(6) 视图 


责 泻 染 返 回 给 客户 端 。 


WAR 


| HÆR Controller. 
回 一 个 ModelAndView 对 象 。 


解析 器 ， 找 到 ModelAndView 对 象 指 定 


在 业务 开发 时 只 涉及 Handler 处 理 器 和 视图 (View) 层 的 编写 ， 其 他 的 组 件 不 需要 开发 ， 
但 还 是 有 必要 了 解 一 下 Spring MVC 的 常用 组 件 ， 见 表 6-1. 
表 6-1 Spring MVC 常用 组 件 
组 件 名 称 作 
前 端 控制 器 (DispatcherServlet) 接收 请 求 ， 响 应 结果 ， 相 当 于 转发 器 ， 使 用 时 通过 配置 实现 
处 理 器 映射 器 〈HandlerMapping) 根据 请 求 的 url 查找 Handler 
Handler 处 理 器 按照 HandlerAdapter 的 要 求 编 号 ， 并 且 处 理 实际 业务 


处 理 器 适配器 (HandlerAdapter ) 


按照 特定 规则 (HandlerAdapter 要 求 的 规则 ) 执行 Handler 


视图 解析 器 (ViewResolver) 


进行 视图 解析 ， 根 据 逻 辑 视图 解析 成 真正 


的 视图 (View) 


视图 (View) View 是 一 个 接 


6.2 ”构建 第 一 个 Spring MVC mE 


> KMAL EHI View 类 型 (jsp, framemark, pdf:--) 


本 节 搭 建 一 个 Spring MVC JHA, SEB 
“new->Maven Project”， 在 弹出 的 对 话 框 中 选择 
单 出 的 输入 框 ! 

<groupId>com.javadevmap</groupId> 

<artifactlId>SpringMV CBasic</artifactld> 

<packaging>war</packaging> 

<version>0.0.1-SNAPSHOT</version> 
使 用 maven build 工程 ， 
indexjsp 页 面 ， 此 页 面 引 用 了 HttpServlet 对 象 ， 
6-3 所 示 。 


ou 


©) Console qj Progress jf! Problems 5% 
1 error, 0 warnings, 0 others 
Description 


v @ Errors (1 item) 


四 The superclass "javax.servlet.http.HttpServlet" was not found on the Java Build Path 


Al 6-3 
打开 pom.xml 文件 ， 添 加 servlet 依赖 ， 


<dependency> 
<groupId>javax.Servlet</groupId> 
<artifactId>javax.servlet-api</artifactId> 


输入 Group Id 和 Artifact Id， 然 后 点 击 Finish. 


会 发 现 项 目 报错 


LAUT 


个 简单 的 页 面 展示 功能 。 打 开 Eclipse， 选 择 
“Maven-archetype-webapp”, 然后 点 击 next, Œ 
体 坐 标 信息 如 下 : 


因 是 由 于 Maven webapp 项 目 默 认 会 创建 
此 依赖 ， 所 以 项 目 报错 ， 如 


当前 pom 文件 没有 


T 
Resource 


indexjsp 


编译 结果 
F: 
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<version>3.0.1</version> 
<scope>provided</scope> 
</dependency> 
然后 再 次 maven build 工程 即 可 。 
创建 常用 package 及 存放 页 面 的 文件 夹 。 如 图 6-4 所 示 。 
图 中 目录 的 含义 如 下 ae 
: > $ v & SpringMVCBasic 

E com.javadevmap.controller: 存放 Spring MVC 的 v Œ src/mainfjava 


=P Fu com,javadevmap.controller 
controller 层 代码 。 ; Ae Pere 由 com.javadevmap.converter 
E com.javadevmap.converter: 存放 自 定义 转换 器 代 comjevadewmapdomain 
ia H 册 com.javadevmap.exception 
但 例如 H 期 转换 器 = com.javadevmap.interceptor 
E com.javadevmap.domain: 存放 业务 对 象 POJO。 comjavadevmap.mybatis.dao 
is : > pay 、 由 comJjavadevmap.mybatis.model 
E com.javadevmap.exception: 存放 自 定义 异常 以 及 全 te 
局 异 常 处 H3S > @ src/test/java 
y : > ED EEN BA JRE System Library [jd 
E com.javadevmap.interceptor: 存放 自 定义 拦截 器 。 mi. Maven Dependencies 


加 com.javadevmap.mybatis.dao: 存放 数据 库 操 作 的 dao Y & s¢ 


v & main 


Bx. =... 
E com. javadevmap.mybatis.model: 存放 数据 库 实 体 类 。 “e aired 
E src/main/webapp: 存放 网 页 及 配置 属性 等 。 E indexjsp 
E web.xml: 用 来 初始 化 配置 信息 ， 例 如 Welcome 页 PS eae 

IMI, Servlet. Servlet-mapping,. filter, listener, JA 2) E pom.xml 

加 载 级 别 等 。 


图 6-4 项 目 目录 结构 


6.2.1 添加 依赖 
创建 完 项 目 后 ， 在 pom 文件 中 添加 Spring MVC 所 需要 的 依赖 ， 具 体 如 下 : 


<dependency> 


<groupId>org.springframework</groupId> 
<artifactId>spring-web</artifactId> 
<version>4.3.3.RELEASE</version> 

</dependency> 

<dependency> 
<groupId>org.springframework</groupld> 
<artifactlId>spring—webmve</artifactld> 
<version>4.3.3.RELEASE</version> 

</dependency> 


6.2.2 ”配置 相关 文件 


根据 之 前 Spring MVC 请 求 处 理 的 流程 ， 需 要 在 web.xml 中 配置 前 端 控 甫 
(DispatcherServlet)， 打 开 “webapp->WEB-INFO->web.xml” 文 件 ， 添 加 如 下 信息 : 


<servlet> 


¥ 


<servlet-name>spring</servlet-name> 
<servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class> 
<init-param> 
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<param-name>contextConfigLocation</param-name> 
<param-value>classpath:spring/spring-*.xml</param-value> 
</init-param> 
<load-on-startup>1</load-on-startup> 
</servlet> 


<servlet-mapping> 
<servlet-name>spring</servlet-name> 
<url-pattern>/</url-pattern> 
</servlet-mapping> 


<Sservlet-name> 属 性 随意 ， 只 要 上 下 一 致 即 可 ，url-pattern 中 的 “/” 表 示 拦 截 所 有 请 求 ， 所 
有 访问 的 地 址 由 DispatcherServlet 进行 解析 ， 使 用 此 种 方式 可 实现 RESTful 风格 的 url. 

上 面 的 contextConfigLocation 用 来 指定 配置 文件 具体 位 置 ， 这 里 配置 的 内 容 为 
classpath:spring/spring-*#.xml，*# 号 为 通配符 ， 即 可 匹配 多 个 以 spring 开头 的 配置 文件 。 
在 resources 文件 夹 下 新 建 一 个 spring 文件 来， 然后 新 创建 一 个 spring-servlet.xml 的 配置 文 
件 ， 用 来 存放 Spring MVC 相关 的 配置 信息 。spring-servlet.xml 具体 配置 如 下 : 


<?xml version="1.0" encoding="UTF-8"?> 
<beans xmlns="http://www.springframework.org/schema/beans" 
xmins:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xmlns:context="http://www.springframework.org/schema/context" 
xmins:mve="http://www.springframework.org/schema/mvc" 
xsi:schemaLocation="http://www.springframework.org/schema/beans 
http://www.springframework.org/schema/beans/spring—beans.xsd 
http://www.springframework.org/schema/context 
http://www.springframework.org/schema/context/spring-context.xsd 
http://www.springframework.org/schema/mve 
http://www.springframework.org/schema/mve/spring-mve.xsd"> 
<! 一 配置 扫描 的 包 一 > 
<context:component-scan base-package="com.javadevmap.*" /> 
<!— 注册 HandlerMapper. HandlerAdapter 两 个 映射 类 -> 
<mvc:annotation-driven /> 
<! 一 访问 静态 资源 一 > 
<mvc:default-servlet-handler /> 
<! 一 视图 解析 器 一 > 
<bean 
class="org.springframework.web.servlet.view.InternalResource ViewResolver"> 
<property name="prefix" value="/WEB-INF/view/"></property> 
<property name="suffix" value=".jsp"></property> 
</bean> 
</beans> 


(1) <context: ee ae >: 用 于 激活 Spring MVC 注解 扫描 功能 ， 该 功能 允许 使 用 注 
解 ， 如 @Controller 和 @RequestMapping 等 。 

(2) InternalResourceViewResolver: bean 视图 解析 器 。 

(3) <mvc:default-servlet-handler />: 访问 静态 资源 。 对 进入 DispatcherServlet 的 URL 进行 
第 查 ， 如 果 发 现 是 静态 资源 的 请 求 ， 就 将 该 请 求 转 给 Web 应 用 服务 器 默认 的 Servlet 处 理 ， 如 果 
不 是 静态 资源 的 请 求 ， 才 由 DispatcherServlet 继续 处 理 。 


中 
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(4) <mvc:annotation-driven >: 注 


册 HandlerMapper、HandlerAdapter 两 个 映射 类 。 


使 用 如 上 配置 会 自动 扫描 com.javadevmap 下 的 所 有 包 中 的 含有 注解 〈 如 @Controller @ Service 


等 ) 的 类 ，<mvc:annotation-driven 信 会 注册 两 个 映射 类 ， 负 责 将 请 求 映射 到 类 的 方法 中 。 


6.2.3 基本 页 面 展示 


为 了 演示 一 个 简单 的 Spring MVC 请 求 的 完整 流程 ， 在 WEB-INF 文件 夹 下 面 创建 一 个 
view 文件 夹 ， 并 在 其 中 创建 一 个 demo.jsp 页 面 。demo.jsp 具体 内 容 如 下 : 
<%@ page language="java" contentType="text/html; charset=UTF-8" 


pageEncoding="UTF-8"%> 


<!DOCTYPE html PUBLIC "~//W3C//DTD HTML 4.01 Transitional//EN" "http:/www.w3.org/ TR/html4/loose.dtd"> 


<html> 
<head> 


<meta http~equiv="Content-Type" content="text/html; charset=-UTF-8"> 


<title> 首 页 </title> 
</head> 
<body> 


<h1>This is SpringMVC Demo</h1> 


</body> 
</html> 


创建 com.javadevmap.controller 包 ( 包 路 径 需 被 扫描 到 )， 在 


体 如 下 : 


创建 WebController X, H 


import org.springframework.stereotype.Controller; 


@Controller 
@RequestMapping("/demo") 
public class WebController { 


@RequestMapping(value="/index", method = RequestMethod.GET) 
public String index() throws CustomException { 


return "demo"; 
} 
} 


@Controller 注解 定义 该 类 作为 一 个 Spring MVC 控制 器 。@RequestMapping 表明 在 该 控制 
器 中 处 理 的 所 有 方法 都 是 相对 于 /demo 路 径 的 。Index 方法 上 的 注解 @RequestMapping 


(value="/index", method = RequestMethod.GET) 


GET 请 求 。 
当 请 求 /demo/index 路 径 时 会 映 


g 


中 ， 返 回 的 字符 串 demo SAED 


置 成 功 。 


射 到 此 


f 接 为 WEB- 


于 匹配 方法 和 请 求 路 径 ， 处 理 /demo/index 的 Http 


口 首页 


G |© localhost:8081/demo 


方法 


6.3 Spring MVC Restful 实现 


软件 风格 其 实 就 是 一 种 约定 ， 统 
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的 软 伯 


INF/view/demojsp， 并 展示 出 来 。 把 此 工程 生成 This is SpringMVC Demo 
war 包 ， 在 Tomcat 中 部 署 运 行 ， 访 问 http://localhost: 
8080/demo/index， 页 面 展 示 如 图 6-5 所 示 ， 说 明 配 


图 6-5 页 面 效 果 


F 风 格 可 以 在 研发 中 提高 代码 的 可 读 性 ， 从 而 在 需 


bb 2> 


要 协作 才能 完 
Restful 实现 。 


成 的 工程 中 ， 


6.3.1 REST 概述 


REST 即 表述 性 状态 传递， 
适合 客户 端 或 服务 端 
在 REST 中 ， 
些 Http 方法 通常 会 

E Create: POST 

E Read: GET 

E Update: PUT 或 PATCH 

E Delete: DELETE 


这 里 用 商品 添加 的 功能 


E http://127.0.0.1/product/delete 


使 用 RESTful 后 的 用 法 : 
E http://127.0.0.1/product/1 
E http://127.0.0.1/product 
E http://127.0.0.1/product 
E http://127.0.0.1/product 


6.3.2 
根据 上 一 节 对 REST 的 理 


框架 将 数据 存放 到 MySQL 中 ，MyBatis 


创建 一 个 返回 数据 的 实体 


保持 风格 的 统一 


资源 通过 URL 进行 识别 
匹配 如 下 动作 : 


举例 ， 
E http://127.0.0.1/product/query/1 
E http://127.0.0.1/product/save 

E http://127.0.0.1/product/update 


REST 4 


， 提 高 协作 的 效率 。 


是 一 种 软件 架构 风格 。REST 是 面向 资 > 
的 形式 从 服务 端 转移 到 客户 端 


和 定位 。 。 P 的 行为 是 通过 


KER 


6% Spring MVC 


第 
KTE 


绍 Spring MVC 的 


原 的 ， 将 资源 的 状态 以 最 


na 


Http 方法 定义 的 。 这 


在 使 用 Restful 之 前 的 请 求 为 : 

GET 根据 商品 id 查询 商品 数据 
POST 新 增 商品 

POST 修改 商品 信息 

GET/POST ”删除 商品 信息 

GET 根据 商品 id 查询 商品 数据 
POST 新 增 商品 

PUT 修改 商品 信息 

DELETE 删除 商品 信息 


创建 REST 风格 的 Controller 


解 ， 基 于 REST 风格 实现 商品 模块 的 增删 改 查 功能 。 使 
RKO WBE A 5 章 。 


集成 步 


ResultBean， 方 便 


package com.javadevmap.domain; 


public class ResultBean { 


private int code;// 状态 码 
private Product data;// 业务 数据 product 


private String msg;// 业务 信息 


public ResultBean() { 


H 


封装 请 求 返 回 数据 、 


public ResultBean(int code, Product data, String desc) { 


this.code = code; 
this.data = data; 
this.msg = desc; 


j 


public static ResultBean ofSuccess(Product obj){ 


ResultBean ret=new ResultBean(); 


1 MyBatis 


通用 的 状态 码 和 描述 
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ret.setCode(200); 
ret.setData(ob)); 
return ret; 
} 
public static ResultBean ofSuccess(String msg){ 
ResultBean ret=new ResultBean(); 
ret.setCode(200); 
ret.setMsg(msg); 
return ret; 
} 
public static ResultBean ofSuccess(Product obj,String msg) { 
ResultBean ret=new ResultBean(); 
ret.setCode(200); 
ret.setData(obj); 
ret.setMsg(msg); 
return ret; 
} 
public static ResultBean ofSuccess(){ 
ResultBean ret=new ResultBean(); 
ret.setCode(200); 
return ret; 
} 
public static ResultBean ofFail(int code,String desc){ 
ResultBean ret=new ResultBean(); 
ret.setCode(code); 
ret.setMsg(desc); 
return ret; 
} 
.省略 get 与 set 方法 
} 
以 产品 信息 的 增删 改 查 为 例 ， 实 现 一 组 REST 风格 的 接口 。 在 com.javadevmap.controller 下 
新 建 一 个 名 为 RestControllerS 的 Controller， 具 体内 容 如 下 : 
@Controller 
@RequestMapping(""/rest") 
public class RestController { 


@Autowired 
ProductModelMapper productModelMapper; 


} 
C1) GET 方法 查询 商品 信息 
@RequestMapping(value="/product/ {prold}",method = RequestMethod.GET) 


public @ResponseBody ResultBean getProductInfo(@Path Variable("prold")Integer prold) { 
System.out.println( "getProductInfo() called with: prold = [" + prold + "]"); 


ProductModel productModel = productModelMapper.selectByPrimaryKey(prold); 
if(null==productModel) { 

return ResultBean.ofFail(501," 未 查询 到 此 商品 "); 
} 


pA 


O 这 里 为 了 演示 方便 ， 在 Controller 中 直接 使 用 了 Mapper， 而 在 实际 业务 中 ， 应 该 在 Controller 中 注入 Service, 4£ Service FY 
入 DAO,， 在 DAO 中 使 用 Mapper。 
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Product product=new Product(); 
BeanUtils.copyProperties(productModel,product); 
return ResultBean.ofSuccess(product," 4 vi KI"); 


BE 


四 


6 章 


Tests 


a — YER A= Spy yp 一 六 = 
通过 Postman? 工具 进行 测试 ， 执 行 效果 如 图 6-6 所 示 。 
get 
GET v http://localhost:8080/rest/product/105 
Authorization Headers (0) Pre-request script 
No Auth v 
Body Cookies Headers(3) Tests (0/0) Status 2000K Time 21ms 
Raw Preview JSONY | H 

tak 

2 code": 200 

六 "data": { 

4 "id": 105, 

5 "productName": "java dev map Book", 

6 "price": 124, 

7 "productDesc": "商品 描述 描述 描述 描述 描述 描述 "， 
8 "productPic": "www.baidu.com/pic/1.jpg" 

2 }, 

10 "msg": "查询 成 功 " 

ii 3} 

vE Ap 
图 6-6 Get 请 求 效果 


(2) POST 方法 增加 单个 商品 


@RequestMapping(value="/product",method = RequestMethod.POST) 


public @ResponseBody ResultBean addProduct(@RequestBody Product product) { 


System.out.println("addProduct() called with: product = [" + product + "]"); 


/业务 逻辑 代码 ….. 

ProductModel productModel=new ProductModel(); 
BeanUtils.copyProperties(product,productModel); 
productModelMapper.insert(productModel); 

return ResultBean.ofSuccess(" 增 加 成 功 "); 


j 
通过 Postman 工具 提交 请 求 并 返回 ， 结 果 如 图 6-7, 
add 
POST v http://localhost:8080/rest/product 


Authorization Headers (1) Body 


form-data x-www-form-urlencoded binary 


Q aw 


"price": 22, 
"productName": 


"“productDesc x 述 i 
"productPic" : “www.baidu.com/pic/1.jpg 


mw 


图 6-7 Post 请 求 参数 


© Postman 是 一 款 功能 强大 的 网 页 调试 与 发 送 网 页 HTTP 请 求 的 Chrome 插件 。 


Pre-request script 


图 6-8 所 示 。 


Tests 


JSON (application/json) W 


Spring MVC 
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add 


POST w | http://localhost:8080/rest/product 


Body Cookies Headers(3) Tests (0/0) Status 2000K Time 4325ms 


Pretty Raw Preview JSON v S| 


Bk 
"code": 200, 
"data": null, 
; "msg": "增加 成 功 " 


UBRWN 


图 6-8 Post 请 求 结果 


(3) PUT 方法 更 新 商品 信息 
@RequestMapping(value="/product",method = RequestMethod.PUT) 
public @ResponseBody ResultBean updateProduct(@RequestBody Product product) { 
System.out.printin("updateProduct() called with: product = [" + product + "]"); 
if(product.getlIdQ—=null) { 
return ResultBean.ofFail(502," 参 数 不 正 确 "); 


} 
ProductModel productModel=new ProductModel(); 


BeanUtils.copyProperties(product,productModel); 
productModelMapper.updateByPrimaryK eySelective(productModel); 
return ResultBean.ofSuccess(" 更 新 商品 成 功 "); 


j; 
\ 日 As 二 < 34 FA 一 
通过 Postman 工具 提交 请 求 并 返回 ， 结 果 如 图 6-9、 图 6-10 所 示 。 
update 
PUT v http://localhost:8080/rest/product 
Authorization Headers (1) Body Pre-request script Tests 
form-data x-www-form-urlencoded @ raw binary JSON (application/json) v 
> "id" :105, 
3 “price”: 124 
42} 
doe Say 
图 6-9 Put 请 求 参数 
update 
PUT v http://localhost:8080/rest/product 
Body Cookies Headers(3) Tests (0/0) Status 2000K Time 932ms 
Pretty Raw Preview JSON w 到 
k 
2 "code": 200, 
3 "data": null, 
4 "msg": "更 新 商品 成 功 " 
5 } 


图 6-10 Put 请 求 结 果 
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(4) DELETE 方法 删除 单个 商品 信息 
@RequestMapping(value="/product/{prold}",method = RequestMethod. DELETE) 
public @ResponseBody ResultBean delProduct(@PathVariable("prold")Integer prold) { 

System.out.println("delProduct() called with: prold = [" + prold + "]"); 

int i = productModelMapper.deleteByPrimaryKey(prold); 

if(i<=0){ 

return ResultBean.ofFail(503," JIER AN"); 
} 
return ResultBean.ofSuccess(" 删 除 成 功 ); 
}; 

通过 Postman 工具 测试 ， 结 果 如 图 6-11 所 示 。 


DELETE v http://localhost:8080/rest/product/105 
Authorization Headers (0) Body Pre-request script Tests 
No Auth v 


Body 3 Status 2000K Time 36ms 


图 6-11 Delete 请 求 结果 
通过 上 面 的 配置 ， 基 本 实现 了 针对 商品 模块 REST 风格 的 接口 APL 


6.4 Spring MVC 拦截 器 


Spring MVC 的 处 理 器 拦截 器 ， 类 似 于 Servlet 开发 中 的 过 滤器 Filter， 用 于 对 处 理 器 进行 预 
处 理 和 后 处 理 。 应 用 场景 有 : 
图 日 志 记 录 : 记录 请 求 日 志 ， 进 行 信息 监控 、 统 计 、 计 算 PV 等 。 
mM 权限 检查 : 请 求 进入 业务 逻辑 处 理 前 ， 进 行 一 些 权限 验证 等 操作 。 
m 性 能 监控 ;通过 进入 拦截 器 和 执行 完 拦 截 器 后 记录 时 间 戳 ， 计 算 请 求 处 理 的 耗 时 。 


6.4.1 FERZY 


在 Spring MVC 中 实现 拦截 器 ， 需 要 实现 HandlerInterceptor 接口 ， 即 Spring 
org.springframework.web.servlet.HandlerInterceptor。 接 口中 提供 三 个 方法 ， 分 别 为 : 


Um 


TAL AY 


(1) public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object 
handler) throws Exception 

进入 Handler 方法 之 前 执行 。 

(2) public void postHandle(HttpServletRequest request, HttpServletResponse response, Object 
handler, ModelAndView modelAndView) throws Exception 

进入 Handler 方法 之 后 ， 返 回 ModelAndView 之 前 执行 。 
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(3) public void afterCompletion(HttpServletRequest request, HttpServletResponse response, 
Object handler, Exception ex) throws Exception 
执行 Handler 完成 后 执行 此 方法 。 


6.4.2 自 定 义 拦 截 絮 


上 一 节 介 绍 了 Spring ae 拦截 器 的 核心 接口 HandlerInterceptor， 本 节 通 过 拦截 器 实现 请 求 处 
理 耗 时 的 性 能 监控 功能 。 定 义 类 HandlerInterceptorTimeConsume， 实 现 HandlerInterceptor 接口 ， 通 
过 在 请 求 处 理 前 和 请 求 处 理 后 a ee 此 类 内 容 如 下 : 


package com.javadevmap.interceptor; 
import org.springframework.core.NamedThreadLocal; 
import org.springframework.web.servlet.HandlerInterceptor; 
import org.springframework.web.servlet.ModelAndView; 
import javax.servlet.http.HttpServletRequest; 
import javax.servlet.http.HttpServletResponse; 
/ 米 米 

* 请 求 耗 时 统计 拦截 器 

yf 
public class HandlerInterceptorTimeConsume implements HandlerInterceptor { 

private NamedThreadLocal<Long> threadLocal = 
new NamedThreadLocal<Long>("execConsumeTime"); 


si 


public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object object) 
throws Exception { 
System.out.printin(""Thread.currentThread().getId() =" + Thread.currentThread().getId()); 
long beginTime = System.currentTimeMillis(); /开始 时 间 
threadLocal.set(beginTime); 
return true; 


} 


public void afterCompletion(HttpServletRequest request, 
HttpServletResponse response, 
Object handler, 
Exception exception) throws Exception { 
long endTime = System.currentTimeMillis(); 
long consumeMills = endTime - threadLocal.get(); 
System.out.println(String.format(" 请 求 RequestURI: %s ; method = %s -> 耗 时 (毫秒 〉%s ", 
request. getRequestURI(), request.getMethod(), consumeMills)); 
} 


public void postHandle(HttpServletRequest request, 
HttpServletResponse response, 
Object handler, 
ModelAndView modelAndView) 
throws Exception { 


} 
将 定义 的 拦截 器 类 在 配置 文件 


cu 
m 
jd 


进行 配置 ， 这 里 针对 所 有 的 请 求 进行 耗 时 统计 。 在 配 : 


O 此 处 记录 时 间 戳 ， 是 使 用 ThreadLocal 记录 开始 时 间 ， 然 后 在 同一 线程 内 ， 和 结束 时 间 进 行 相 减 ， 从 而 计算 出 来 的 。 
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蚊 性 来 匹配 拦截 规则 ， 将 


De 


F 中 增加 了 一 个 <mvc:interceptors> 标 签 ， 通 过 <mvc:mapping> 的 patch 
定义 的 拦截 器 通过 <bean> 映 射 进 来 。 具 体 如 下 : 
<! 一 拦截 器 一 > 
<mve:interceptors> 
<! 一 多 个 拦截 器 ,顺序 执行 一 > 
<mvc:interceptor> 
<! 一 /** 表 示 所 有 url 包括 子 url 路 径 一 > 
<mve:mapping path="/**"/> 
<bean 
class=" 
</mve:interceptor> 
</mve:interceptors> 


接 下 来 访问 之 前 定义 的 请 求 接口 : 
http://localhost:8080/rest/product/107 

控制 台 输 出 如 下 信息 : 
Thread.currentThread().getId()= 31 


getProductInfo() called with: prold = [107] 
请 求 RequestURI: /rest/product/107 ; method =GET -> 耗 时 CŒ) 7 


通过 上 面 的 输出 信息 ， 可 见 拦截 器 能 够 计算 一 个 请 求 的 响应 时 间 ， 如 果 想 更 加 完善 ， 可 以 
自 定 义 一 个 阔 值 进行 预警 等 。 


6.4.3 -拦截 如 执行 规则 


接 下 来 通过 定义 两 个 拦截 器 来 观察 拦截 器 的 执行 规则 ， 定 义 拦 截 器 HandlerInterceptorl 和 
HandlerInterceptor2 ， 两 个 类 具体 内 容 大 致 相同 ， 都 是 在 方法 执行 时 打印 自己 的 拦截 器 名 称 加 方 
法 名 。HandlerInterceptorl 具体 如 下 : 


package com.javadevmap.interceptor; 
import org.springframework.web.servlet.HandlerInterceptor; 
import org.springframework.web.servlet.ModelAndView; 
import javax.servlet.http.HttpServletRequest; 
import javax.servlet.http.HttpServletResponse; 
JER 
* 拦截 器 
a 
public class HandlerInterceptorl implements HandlerInterceptor { 
/进入 Handler 方法 之 前 执行 
public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) 
throws Exception { 
System.out.printIn("HandlerInterceptor1 ...preHandle "); 
//return false 表示 拦截 ， 不 向 下 执行 
//return true 表示 放行 
return true; 


ih 
pam) 


com.javamapdev.interceptor.HandlerInterceptorTimeConsume"></bean> 


} 


/进入 Handler 方法 之 后 ， 返 回 modelAndView 之 前 执行 
public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, 
ModelAndView modelAndView) throws Exception { 
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System.out.printIn("HandlerInterceptor1 ...postHandle"); 
} 


// 执 行 Handler 完成 执行 此 方法 
public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, 
Exception ex) throws Exception { 
System.out.println("HandlerInterceptor1 ...afterCompletion"); 
} 
} 


HandlerInterceptor2 具体 如 下 : 


package com.javadevmap.interceptor; 
import org.springframework.web.servlet.HandlerInterceptor; 
import org.springframework.web.servlet.ModelAndView; 
import javax.servlet.http.HttpServletRequest; 
import javax.servlet.http.HttpServletResponse; 
[** 
* 拦截 器 
x 
public class HandlerInterceptor2 implements HandlerInterceptor { 
/进入 Handler 方法 之 前 执行 
public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) 
throws Exception { 


System.out.printIn("HandlerInterceptor2 一 > _ preHandle"); 
//return false 表示 拦截 ， 不 向 下 执行 

//return true 表示 放行 

return true; 


} 


// 进 入 Handler 方法 之 后 ， 返 回 modelAndView 之 前 执行 
public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, 
ModelAndView modelAndView) throws Exception { 
System.out.println("HandlerInterceptor2 一 -> postHandle"); 


} 


// 执 行 Handler 完成 执行 此 方法 
public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, 
Exception ex) throws Exception { 


System.out.println("HandlerInterceptor2 一 > afterCompletion"); 
} 
j 
然后 在 spring-servlet.xml 文件 中 配置 此 拦截 器 。 有 具体 如 下 : 
<! 一 拦截 器 一 > 


<Imvc:interceptorS> 
<! 一 多 个 拦截 器 ,顺序 执行 一 > 
<mvc:interceptor> 
<! 一 /** 表 示 所 有 url 包括 子 url 路径 一 > 
<mvc:mapping path="/**"/> 
<bean class="com.javamapdev.interceptor.HandlerInterceptor1"></bean> 
</mve:interceptor> 
<mve:interceptor> 
<mve:mapping path="/**"/> 
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<bean class="com.javamapdev.interceptor.HandlerInterceptor2"></bean> 
</mve:interceptor> 
</mvc:interceptors> 


这 日 


E HandlerInterceptorl 和 HandlerInterceptor2 两 个 拦截 器 的 拦截 路 径 规 则 配置 一 致 。 请 求 


之 前 定义 的 页 面 ， 探 人 


HandlerInterceptor1 ...preHandle 
HandlerInterceptor2 一 -> preHandle 

getProductInfo() called with: prold = [107] 
HandlerInterceptor2 一 -> postHandle 
HandlerInterceptor1 ...postHandle 

HandlerInterceptor2 一 -> afterCompletion 
HandlerInterceptor1 ...afterCompletion 


可 以 自行 设置 搓 


器 方法 返回 的 拦 


判 台 输出 如 下 信息 : 


RIRE true (放行 ) 或 者 false 〈 不 放行 )， 和 


H] 
sF 


E 拦截 器 1 放行 ， 拦 截 器 2 preHandle 才 会 执行 。 
m 拦截 器 2 preHandle 不 放行 ， 拦 截 器 2postHandle 和 afterCompletion 不 会 执行 。 


加 只 要 有 一 个 拦 


6.5 Spring MVC 异常 处 理 


请 求 ， 后 全 服务 如 果 发 生 寞 常 ， 前 


返回 数据 ， 可 以 使 用 Spring MVC 提 


= 


AA 


发 Web 应 用 的 时 候 ， 请 求 处 理 过 程 


a 
HO 


7N 


， 根 据 异 常 信息 向 前 


WA 3 种 方式 : 


I 


的 全 


a 
口 


转 到 该 拦截 器 中 处 怕 

6.5.1 Spring MVC 异常 处 理 方式 
Spring MVC 处 理 异 
m 使 用 Spring MVC 提供 
加 实现 Spring 的 异常 处 理 接 


m 使 ) 
本 节 使 


HandlerExceptionResolver 自 定义 


P 的 错误 和 
上 无 法 获得 任何 请 求 结果 。 义 
局 异常 拦截 器 ， 保 证 当 
返回 不 同 的 页 面 或 者 数据 。 


ae DBT, postHandle 都 不 会 执行 。 


FRE 


经 常 发 生 的 。 例 如 Ajax 方式 发 起 
1 果 和 希望 前 台 能 够 获得 请 求 的 


rt He 
台 业 务 处 理 抛 出 异常 后 ， 会 


的 简单 异常 处 理 器 SimpleMappingExceptionResolver。 


,的 异常 处 理 


U 


: N 
: 校 验 失败 

: 资源 不 可 用 
: 找 不 到 
: 不 文 持 的 请 求 
: 没有 和 请 求 accept IE 
: 不 文 持 的 MIME 类 型 
500: 


青 求 错误 


匹配 的 


服务 内 部 错误 


方法 


6.5.2 ”实现 自 定 义 异 常 处理 类 


平时 业务 开发 ， 有 


的 请 求 返 回 


J@ExceptionHandler 注解 实现 异常 处 理 。 


用 HandlerExceptionResolver 方式 来 处 理 
在 处 理 异常 之 前 ， 需 要 了 解 一 下 HTTP 请 求 常 见 的 响应 状态 码 : 


CHJ MIME 类 型 


全 局 异常 。 


Json 数据 ， 所 以 针对 异常 也 要 分 情况 进行 处 理 
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下 面 实现 的 寞 


ay = 


首先 定义 


常 。 实 现 这 个 功能 的 核心 是 根据 请 求 头 进行 判断 ， 普 通 请 求 与 Ajax RAE Ajax 请 求 头 
A 


党 处 理 功能 ， 既 能 处 理 普通 请 求 Web 页 面 的 异常 ， 也 能 处 理 Ajax 请 求 的 异 


了 Xx-requested-with， 通 过 区 分 不 同 请 求 头 从 而 反馈 给 客户 端 不 同形 式 的 异常 信息 。 


个 自 定义 异常 ， 用 于 业务 出 现 问 题 时 主动 抛 出 此 异常 。 具体 如 F: 


package com.javadevmap.exception; 
public class CustomException extends Exception { 
public CustomException() { 


} 


public CustomException(String message) { 


} 
j 


本 节 使 用 


Super(message); 


| HandlerExceptionResolver 方式 来 处 理 全 局 异常 ， 所 以 需要 在 包 com.javadevmap. 


exception 下 新 建 一 个 CustomExceptionResolver 类 并 且 实 现 a E AN 接口 。 有 具体 
内 容 如 下 : 
public class CustomExceptionResolver implements HandlerExceptionResolver { 

protected static final String DEFAULT ERROR MESSAGE = "系统 忙 ， 请 稍 后 再 试 "; 


/** 


* @param ex 系统 抛 出 的 异常 


z 


public ModelAndView resolveException(HttpServletRequest request, HttpServletResponse response, 
Object handler, Exception ex) { 


} 


String errorMsg = ex instanceof CustomException ? 
ex.getMessage() : DEFAULT ERROR MESSAGE; 
String errorStack = Throwables.getStackTraceAsString(ex); 
System.out.printf("Request: %s raised %s", request.getRequestURI(), errorStack); 
ModelAndView modelAndView =null; 
/如 果 是 Ajax 请 求 响应 头 会 有 x-requested-with 
if (request.getHeader("x-requested—with") != null && 
request.getHeader("x-requested-with").equalsIgnoreCase("XMLHttpRequest")) { 
modelAndView = handleAjaxError(response,errorMsg); 
}else{ 
// 非 Ajax 请 求 时 ，session 失效 的 处 理 
modelAndView = handleViewError(request.getRequestURI(),ex.get Message(),"error"); 


} 


return modelAndView; 


Mas 


针对 Web 页 面 的 异常 处 理由 handleViewError 方法 具体 实现 ， 此 方法 会 返回 一 个 错误 页 面 。 
protected ModelAndView handleViewError(String url, 
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String errorMessage, 
String viewName) { 


ModelAndView mav = new ModelAndView(); 
mav.addObject("url", url); 


/将 


背 误 信息 传 到 页 务 


mav.addObject("message", errorMessage); 


// 指 向 错误 页 面 


mav.setViewName(viewName); 
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return mav; 


} 


定义 一 个 错误 页 面 ， 在 WEB-INF/view 文件 夹 下 面 定 义 一 个 errorjsp 页 面 ， 用 来 显示 错误 
信息 。 具 体内 容 如 下 : 


<%@ page contentType="text/html;charset=UTF-8" language="java" %> 
<html> 

<head> 

<title> 错 误 页 面 提示 </title> 
</head> 
<body> 
背 误 信息 : ${message} 
</body> 
</html> 


而 针对 Json 接口 异常 由 handleAjaxError 方法 具体 实现 ， 此 方法 会 在 response 中 返回 错 
误 信 A : 


protected ModelAndView handleAjaxError(HttpServletResponse rsp, String errorMessage) { 
try{ 
rsp.setCharacterEncoding("UTF-8"); 
rsp.setContentType("application/json;charset=utf-8"); 
rsp.setStatus(HttpStatus.OK.value()); 
PrintWriter writer = rsp.getWriter(); 
ResultBean bean=ResultBean.ofFail(500,errorMessage); 
ObjectMapper mapper = new ObjectMapper(); 
//ResultBean 类 转 JSON 
String json = mapper.writeValueAsString(bean); 
System.out.printInGson); 
writer.write(json);// 输出 
writer. flush(); 
writer.close(); 
}catch (Exception e) { 
e.printStackTrace(); 


} 


return null; 


} 
为 了 演示 异常 处 理 效 果 ， 定 义 了 一 个 Controller 类 ExceptionController， 分 别 为 普通 请 求 和 
Ajax 请 求 主动 抛 出 异常 。 


@Controller 
@RequestMapping("/exception") 
public class ExceptionController { 
@RequestMapping("/web") 
public String index() throws CustomException { 
/业务 处 理 
== 此 条 件 判断 是 为 了 抛 出 自 定 义 异 常 
throw new CustomException(" 页 面 请 求 出 现 了 异常 "); 


TT 


} 


return "demo"; 
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@RequestMapping(value="/json" method = RequestMethod.POST) 
public @ResponseBody ResultBean addProduct(@RequestBody Product product)throws 
CustomException { 
System.out.printin("addProduct() called with: product = [" + product + "]"); 
/业务 逻辑 代码 ….. 
if(1==1){// 抛 出 自 定义 异常 
throw new CustomException("Ajax 请 求 出 现 了 异常 "); 


return ResultBean.ofSuccess(); 


} 


} 
普通 页 面 抛 出 异常 ， 测 试 结果 如 图 6-12 所 示 。 


© localhost:8081/exception/web 


图 6-12 异常 页 面 
Ajax 页 面 抛 出 异常 ， 测 试 结果 如 图 6-13 所 示 。 


€ Cc | © localhost:8080/testjsonException.jsp 
请 求 体 为 : 
{"id":"3000","name":"Apple 
iPhone X"} 
A 
服务 器 返回 结果 : 


{"code":500,"data":null,"msg":"Aj 
ax 请 求 出 现 了 异常 "} 


Z| 


图 6-13 接口 异常 


本 节 实 现 了 既 能 处 理 普 通 请 求 也 能 处 理 Ajax 请 求 的 异常 处 理 器 。 实 际 业 务 代码 


于 发 的 时 


候 ， 建 议 与 业务 功能 相关 的 异常 ， 在 Service 中 抛 出 ， 而 与 业务 无 关 的 异常 在 Controller 层 抛 


出 ， 然 后 在 异常 处 理 器 中 进行 统一 捕获 并 返回 数据 。 


6.6 Spring MVC 上 传 和 下 载 文件 


在 平时 业务 开发 过 程 中 ， 文 件 的 上 传 和 下 载 是 很 常见 的 场景 。 例 如 前 面 实现 的 商品 模块 ， 

商品 中 有 对 应 图 片 资 源 ， 此 功能 就 涉及 图 片上 传 和 下 载 的 功能 。Spring MVC 为 文件 上 传 提供 了 
直接 的 支持 ， 这 种 支持 是 由 MultipartResolver 实现 的 。Spring MVC 使 用 Apache Commons 
FileUpload 技术 实现 了 一 个 MultipartResolver 实现 类 一 一 CommonsMultipartResolver 。 


因此 ， 


Spring MVC 的 文件 上 传 需 依 赖 Apache Commons FileUpload 的 组 件 。 本 节 实 现 基于 Spring MVC 


的 文件 上 传 和 下 载 功 能 。 
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6.6.1 MultipartFile 对 象 


Spring MVC 会 将 上 传 的 文件 


FE = 


3 6% Spring MVC 


绑 定 到 MultipartFile 对 象 中 。MultipartFile 提供 了 获取 上 传 文 


件 内 容 、 文 件 名 等 方法 。 通 过 transferTo0) 方 法 还 可 以 将 文件 存储 到 本 地 。MultipartFile 对 象 中 的 
HATTIE WAR 6-2. 
326-2 MultipartFile 常用 方法 
方 法 名 作 
byte[] getBytes() 获取 文件 数据 
String getContentType[] 获取 文件 MIME 类 型 ， 如 image/jpeg 等 
InputStream getInputStream() 获取 文件 流 


String getName() 获取 表单 中 文件 组 件 的 名 字 
String getOriginalFilename() 获取 上 传 文件 的 原名 
Long getSize() 获取 文件 的 字 节 大 小 ， 单 位 为 byte 
boolean isEmpty() 检测 是 否 有 上 传 文件 
void transferTo(File dest) 将 上 传 文件 保存 到 一 个 目录 文件 中 
了 解 并 掌握 MultipartFile 的 常用 方法 ， 可 轻松 实现 文件 上 传 。 
6.6.2 上 传 文件 
在 之 前 商品 模块 基础 上 ， 增 加 商品 图 片上 传 功能 ， 将 前 端 传递 的 图 片 信息 以 及 图 片 资源 存 


放 到 服务 器 ， 
上 传 文件 ， 必 须 将 页 面 
multipart/form-data。 这 样 ， 浏 览 
一 旦 设置 
Spring MVC 


上 下 文 默 


在 spring-servlet.xml 中 配置 multipart 类 


A= a Ee = 


<bean id="multipartResolver" 


j ee 保存 到 数据 库 中 


表单 的 method 方法 设置 

才 会 把 用 户 选 择 的 文件 以 
了 enctype 为 multipart/form-data， 浏 览 
认 没 有 装配 MultipartResolver， 因 
型 解析 器 ， 具 体内 容 妇 


o 


A 


为 POST， 并 将 enctype 设置 为 


Ei 


| 数据 的 形式 发 送 给 服务 端 。 


U 


SARH 


EMA RREK A 


数据 。 


此 不 能 
IF: 


接 处 理 


文件 上 传 ， 需 要 先 


class="org.springframework.web.multipart.commons.CommonsMultipartResolver"> 


<! 


y 


<property name="maxUploadSize"> 
<value>5242880</value> 


:上传 文件 的 最 大 尺寸 为 5MB 一 > 


</property> 
</bean> 
在 WEB-INFO/view 文件 夹 新 建 一 个 图 片上 传 页 面 UploadFilejsp: 
<%@ page language="java" contentType="text/html; charset=UTF-8" 
pageEncoding="UTF-8"%> 

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http:/Avww.w3.org/TR/ html4/ loose.dtd'> 
<html> 

<head> 


<meta http-equiv="Content-Type" content="text/html; charset=-UTF-8"> 


<title> 文 件 上 传 </title> 
</head> 
<body> 
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<h2> 文 件 上 传 <h2> 
<form action="upload" enctype="multipart/form—data" method="post"> 
<table> 
<tr> 
<td> 商 品 ID:</td> 
<td><input type="text" name="productld"></td> 
</tr> 
<tr> 
<td> 文 件 描述 :</td> 
<td><input type="text" name="description"></td> 
</tr> 
<tr> 
<td> 请 选择 文件 :</td> 
<td><input type="file" name="file"></td> 
</tr> 
<tr> 
<td><input type="submit" value=" 上传 "></td> 
</tr> 
</table> 
</form> 
</body> 
</html> 


在 工程 包 com.javadevmap.controller 下 面 创 建 一 个 FileUploadContro 
时 业务， 具体 内 容 如 下 : 
@Controller 


@RequestMapping("/file") 
public class FileUploadController { 


H 


ller 类 ， 


@RequestMapping(value = "/uploadFile", method = {RequestMethod.POST, 
RequestMethod.GET}) 


public String uploadFile() throws Exception { 
return "uploadFile"; 
} 
j 


部 署 服务 到 Tomcat 上 ， 访 问 路 径 为 : 
http://localhost:8080/file/uploadFile 
页 面 效 果 如 图 6-14 所 示 。 


文件 上 传 


商品 ID: 
文件 描述 : 
请 选择 文件 : 选择 文 


图 6-14 文件 上 传 页 面 


在 FileUploadController 中 添加 uploadProductPic 方法 用 来 接收 文件 ] 
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上 传 请 求 。 


来 接收 请 求 处 


第 6 章 Spring MVC 


@Autowired 
ProductModelMapper productModelMapper;//dao 


@RequestMapping(value = "/upload", method = RequestMethod.POST) 
public String uploadProductPic( 
HttpServletRequest request, 
Model model, 
@RequestParam("productld") int productId, 
@RequestParam("description") String description, 
MultipartFile file) throws Exception { 
System.out.println(description); 
/原始 名 称 
String originalFilename = file.getOriginalFilename(); 
String newFileName =null; 
/上 传 图 片 
if (file != null && originalFilename != null && originalFilename.length() > 0) { 
/存储 图 片 的 物理 路 径 
String path = request.getServletContext().getRealPath("."); 
System.out.println(path); 
/新 的 图 片 名 称 
newFileName = "javadevmap" + 
originalFilename.substring(originalFilename.lastIndexOf(".")); 
System.out.printIn("newFileName = " + newFileName); 
// 新 图 片 


File newFile = new File(path ,newFileName); 


// 将 内 存 中 的 数据 写 入 磁盘 
file.transferTo(newFile); 
model.addAttribute("title", "文件 上 传 "); 
model.addAttribute("message", "文件 上 传 成 功 "); 
model.addAttribute("originalFilename", originalFilename); 
model.addAttribute("newFileName", newFileName); 
}else{ 
model.addAttribute("title", "文件 上 传 "); 
model.addAttribute("message", "文件 上 传 失 败 "); 


} 
/ 更 新 商品 信息 
ProductModel productModel = productModelMapper.selectByPrimaryKey(productld); 
if(null != productModel) { 
model.addAttribute("productName", productModel.getProductName()); 
productModel.setProductPic(""download? filename="+newFileName); 
productModel.setProductDesc(description); 
productModelMapper.updateByPrimaryKeySelective(productModel); 


} 


return "status"; 
} 
根据 前 端 传递 过 来 的 图 片 ， 将 文件 重 命 名 并 保存 到 服务 器 指定 位 置 ， 然 后 跳 转 到 指定 的 结 
果 页 。 在 WEB-INFO/view 文件 夹 新 建 一 个 status.jsp 文件 用 来 展示 上 传 结果 : 


Ans 


java" %> 


<%@ page contentType="text/html;charset=UTF-8" language 
<html> 
<head> 

<title>$ {title}</title> 
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上 传 文件 后 ， 页 面 效 果 如 图 


</head> 
<body> 
<div> 
商品 : 
${productName} 
</div> 
<div> 
文件 上 传 结果 : 
${message} 
</div> 
</body> 
</html> 


6.6.3 下 载 文件 


除了 文件 上 传 功能 ， 平 


代码 
FileUpload 组 人 


HTTP 协议 消息 头 中 ， 


置 成 下 载 文件 路 径 ， 
Spring MVC 提供 了 一 个 ResponseEntity 类 型 ， 使 月 
和 HttpStatus。 在 FileUploadController 中 


6-15 所 示 。 


时 业务 下 载 功能 也 必 不 可 
少 。 接 下 来 ， 实 现 商 品 图 片 下 载 功能 。 文 件 下 载 相对 简 
单 ， 直 接 在 页 面 给 出 一 个 超 链接 ， 该 链接 的 href 属性 设 
点 击 超 链接 浏览 器 将 执行 文件 下 载 。 
它 可 以 很 方便 地 定义 返回 的 HttpHeaders 
增加 下 载 方法 ， 代 人 码 如 下 : 


@RequestMapping(value = "/download") 
public ResponseEntity<byte[|> download(HttpServletRequest request, 
@RequestParam("filename") String filename, 
Model model) throws Exception { 


/下 载 文件 路 径 


商品 : 


a 
( 


© localhost 


java dev map Book 


文件 上 传 结果 : NEERI 


String path = request.getServletContext().getRealPath("."); 


File file = new File(path + File.separator + filename); 
HttpHeaders headers = new HttpHeaders(); 


/全 载 显 示 的 文件 名 ,解决 
String downloadFileName = new String(filename.getBytes("UTF-8"), "iso—8859-1"); 
/通知 浏览 器 以 attachment 〈 下 载 方式 ) FT 


P 文 名 称 乱 码 问题 


图 片 


图 6-15 


headers.setContentDispositionFormData("attachment", downloadFileName); 
二 进 制 流 数 据 ( 最 常见 的 文件 下 载 )。 


//application/octet-stream : 


headers.setContentType(MediaType.APPLICATION OCTET STREAM); 
return new ResponseEntity<byte[]>(FileUtils.readFileToByteArray(file), 
headers, HttpStatus; CREATED); 


} 


Ph 定义 了 download 方法 ， 此 方法 接 
HAY FileUtils 读 取 服 务 器 本 地 文件 ， 

使 用 ResponseEntity 对 象 ， 可 以 很 方便 地 定义 返 
的 MediaType9， 代 表 的 是 Internet Media Type, El 
使 用 Content-Type 来 表示 具 


构建 成 ResponseEntity 对 象 返 


文件 上 传 成 功 页 面 


疏 页 面 传递 的 文件 名 后 ， 使 用 Apache Commons 


H 


客户 端 下 载 。 


器 的 HttpHeaders 和 HttpStatus 


互联 网 媒体 类 型 ， 


© Internet Media Type， 有 时 在 一 些 协议 的 消息 头 中 叫 作 “Content-T 


148 


ARH 


的 媒体 类 型 信息 。HttpStatus 


它 使 


ype” 


也 叫 作 MIME 类 型 。 


。 上 面 代码 中 


在 
类 型 代 


FINE 


两 部 分 标识 符 来 确定 一 个 类 型 。 


AE se 


F 0 证 


表 的 是 HITP 协议 中 的 状态 。 


为 了 查看 效果 ， 修 改 statusjsp 页 面 ， 具 体 如 下 : 


<%@ page contentType="text/html;charset=UTF-8" language="java" %> 
<html> 
<head> 
<title>$ {title}</title> 
</head> 
<body> 
<div> 
商品 : 
$ {productName} 
</div> 
<div> 
文件 上 传 结果 : 
$ {message} 
</div> 
<hr> 
<img src="download?filename=$ {newFileName}"/> 
<h3> 文 件 下 载 <h3> 
<a href="download? filename=$ {newFileName}"> 
${originalFilename } 
</a> 
</body> 
</html> 


部 署 服 务 到 Tomcat E, W EKN: 


http://localhost:8080/file/uploadFile 


Spring MVC 


上 传 图 片 后 运行 效果 如 图 6-16 所 示 ， 当 点 击 图 片 名 称 时 ， 会 进行 图 片 下 载 操作 。 


$ C © localhost: 


商品 : java dev map Book 
文件 上 传 结果 : 文件 上 传 成 功 


图 6-16 Seer FRK 


本 节 实 现 了 Spring MVC 文件 的 上 传 和 下 载 功 能 ， 实 际 业务 开发 时 ， 考 处 到 怕 
等 因素 ， 一 般 会 把 文件 存放 到 FastDFS? (第 14 章 会 有 介绍 ) 中 ， 或 者 阿里 的 OSSS 服 务 器 上 。 


© FastDFS 是 一 个 开源 的 高 性 能 分 布 式 文件 系统 ， 它 的 主要 功能 包括 : 文件 存储 、 文 件 同步 和 文件 访问 ， 具 


衡 的 能 力 。 


能 、 访 问 速度 


备 了 大 容量 和 负载 均 


O OSS: 阿里 云 对 象 存储 服务 (Object Storage Service, 简称 OSS) ， 是 阿里 云 提供 的 海量 、 安 全 、 低 成 本 、 高 可 靠 的 云 存储 服务 。 
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HUTA AR EAN Hh Sp A 


57% Spring Boot 


了 Spring 的 能 力 ， 相 信 大 家 对 Spring 已 经 


了 


cu 


Spring Boot 和 Spring 


的 


之 闻 存 在 什么 联系 呢 ? 


Spring 的 核心 型 
想 ，Spring 确实 做 出 


使 如 此 ，Spring 还 是 没有 逃脱 大 量 的 配置 工作 ， 例 如 引入 外 部 工程 依赖 时 的 配 
管理 大 量 的 工程 依赖 时 ， 各 个 依赖 版 本 间 的 兼容 性 和 配置 
问题 与 Spring 的 初衷 相悖， 


E 念 是 让 研发 者 专 演 


FE 于 业务 的 逻辑 ， 而 不 过 分 考虑 框架 的 治 


了 很 多 改进 ， 例 如 使 有 


H XML 进行 配置 和 后 期 的 使 


可 以 把 Spring Boot #4 


你 会 发 现 Spring Boot 


对 Spring Boot 做 最 精 要 的 提炼 ， 目 的 是 让 大 家 快速 了 解 Spring Boot 的 # 


E 解 为 
Spring Boot 的 使 用 会 让 编程 更 加 


简化 # 


日 丰富 了 的 Spring. 
简单 ， 更 加 专注 于 业务 ， 如 果 对 上 
到 底 有 多 大 。 这 些 改 进 基 了 


的 改进 


日 注解 进行 


EC 


= = 基于 出 


日 
Fe 


=i 


为 明 


属性 烦琐 等 问题 变 得 更 
所 以 Spring Boot 的 出 现 就 是 Spring 初衷 继续 


“EEE 
JA 


上 上 面 Spring MVC 的 本 
F Spring Boot 的 自动 配置 和 起 步 依赖 。 本 | 


7.1 构建 第 一 个 Spring Boot 工程 


正如 前 面 所 说 ， 
具备 非常 简单 的 
了 什么 能 力 。 


发 者 更 专注 于 业务 ,为 


BAI 


Spring Boot 让 在 


7.1.1 IDE 搭建 及 特性 


] Spring Initializr 创建 工程 


奇 之 处 。 


[ 程 的 构建 必须 方便 4 
匡 架 能 力 ， 下 面 创建 一 个 Spring Boot THE, AF Spring Boot 初始 工程 已 经 具备 


彻 的 升级 版 。 基 


ME o 


It 


we) 


Wer 


H 


Livy 


里 解 。 那 么 


H 


CHo (HBH 
$ ETRE 
这 些 


快速 ， 


览 器 打 


通过 ; 
程 依赖 管 
例如 Group 等 ， 就 可 


ian 


个 流 和 


(2) 
STS (spring tool 


过 
网 络 连 接 的 畅通 。 


下 面 使 用 STS 创建 第 


而 


如 


7-2 所 示 页 面 。 


© 在 后 面 的 演示 


理工 具 、 选 择 语 言 和 Spring Boot 版 本 这 些 基 而 


EE IDE 都 没有 使 用 就 完成 了 一 个 Spring Boot 工程 的 
| STS 创建 了 


松 创建 Spring Boot 工程 。 
这 里 不 再 介绍 。 在 STS 


pb 选择 Maven 进行 了 


图 7-1 所 示 页 
1 选项， 然后 
最 后 点 二 
BJE. 


http://start.spring.io 网 址 ， 会 显示 如 


mi 


各 


E9 


以 轻松 创建 一 个 Spring Boot 


po 


suite〉 是 一 个 定 和 
H 


Hl Eclipse, %& 4 Spring J 
可 以 访问 https:/spring.io/tools/sts/all F 4% STS, 
中 创建 Spring Boot 


口 


[ 程 。 


色 一 个 Spring Boot 了 


语言 


[ 程 管理 ， 使 


Java 作为 开发 Spring Boot 版 本 使 


口 


7N 


PAIN RE A 


Al, EWH! 


要 r$ 


1.5.10+. 


lati» 
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过 程 很 简单 ， 


PAL 


可 以 选择 工 
入 自己 的 工程 属性 
I; Generate Project 进行 下 载 ， 整 


Bl, ZE STS 中 可 以 轻 
具体 安装 
工程 时 其 实 是 依赖 Spring Initializr 的 ， 所 以 必须 保证 


执行 “File->New->Spring Start Project”, 可见 


© Spring Initializr x 


C |© startspring.io 
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SPRING INITIALIZR 


Generate a 


Project Metadata 
Artifact coordinates 
Group 


com. example 


Artifact 


deno 


Maven Project v with 


" and Spring Boot 20: ， 


Java 


Dependencies 


Add Spring Boot Starters and dependencies to your application 
Search for dependencies 


Web, Security, J Actuat 


Selected Dependencies 


Generate Project alt + 4 


Don't know what to look for? Want more options? Switch to the f e 


start.spring.io is powered by 


New Spring Starter Project 


Service URL 


Name 


Location 
Type: 

Java Version: 
Group 
Artifact 
Version 
Description 


Package 
Working sets 


and 


Use default location 


Add project to working sets 


Al 7-1 Initializr WH 
口 x 
http://start.spring.io {v 
SpringBootBasic 
D:\projects\JavaDeveloperMap\SpringBootBasid Browse 
Maven ~ Packaging: Jar v 
8 ~ Language: Java {v 
comJjavadevmap 
SpringBootBasic 
0.0.1-SNAPSHOT 
First project for Spring Boot 
com,javadevmap.basic 
New... 
Select... 
TE — E 


图 


7-2 创建 工程 


D) 


[hunf 


在 页 面 中 ， 逐 项 填写 工程 信息 ， 点 击 Next， 即 进入 起 步 依赖 选择 页 面 ， 如 图 7-3 所 示 ， 这 
里 选择 Web 依赖 作为 该 项 目的 起 步 依 赖 。 
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New Spring Starter Project Dependencies rie % 


Spring Boot Version: | 1.5.10 {v 


Available: Selected: 


web 


X Web 


v Core 


Validation 


Mj Web 


Reactive Web 


Rest Repositories 


Web Services 

Jersey (JAX-RS) 
Websocket 

Vaadin 

Apache CXF (JAX-RS) 
Mobile 


Make Default Clear Selection 


© < Back Next > Cancel 
图 7-3 添加 依赖 


到 此 ， 一 个 简单 的 Spring Boot 工程 创建 完毕 ， 虽 然 这 仅仅 是 一 个 新 建 的 工程 ， 但 是 它 已 经 
具备 了 Web 能力 ， 只 要 简单 地 添加 一 个 方法 即 可 完成 一 个 Web 接口 的 编写 工作 ， 而 不 需要 像 之 
前 那样 进行 烦琐 的 配置 。 


7.1.2 工程 日 录 v tS SpringBootBasic [boot] UavaDeveloperMap master] 
本 节 将 介绍 Spring Boot 工程 的 目录 结构 ， 并 且 创建 Sme 


v $ comjavadevmap.basic 


第 一 个 Spring Boot 工程 的 Web 接 Ee 工程 的 目 录 结 构 如 [Ñ SpringBootBasicApplicationjava 
v @® src/main/resources 
7-4 所 示 。 or 


各 个 模块 的 分 工 较为 明确 ， 每 个 根 目 录 都 有 自己 的 rps 
application.properties 


职责 划分 ， 具体 如 下 : ve ernie 
图 src/main/java: 用 于 业务 逻辑 代码 的 编写 ，Java 代 V comiyavadevmap. basic 


因 SpringBootBasicApplicationTests.java 


IEE E mi JRE System Library [JavaSE-1.8] 
E SpringBootBasicApplication.java 文件 : 工程 的 启 Ben Dopendenges 

动 文 件 ， 承 担 了 非常 重要 的 职责 ， 它 会 通过 Eurot 

@SpringBootApplication 注解 进行 自动 配置 并 扫描 = T 

它 及 以 下 层级 的 目录 里 的 文件 进行 自动 配置 。 R pom.xml 


图 src/main/resources: 用 于 存放 资源 ， 其 中 static 用 图 7-4 工程 目录 
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于 存放 静态 资源 ，templates 用 于 存放 页 面 模板 application.properties 是 工程 配置 文件 ， 
可 以 把 其 改名 为 application.yml 文件 ， 从 而 采用 其 他 配置 书写 格式 。 
E src/test/java: 用 于 存放 测试 代码 ，SpringBootBasicApplicationTests.java 可 以 获得 工程 上 下 
文 并 且 进 行 测试 。 
E pom: Mavan 依赖 管理 文件 ， 特 殊 的 地 方 就 是 包含 了 spring—boot-starter-parent 这 个 父 依赖 
并 且 自 动 添加 了 spring-boot-maven-plugin 打包 工具 和 test 依赖 。 
了 解 目 录 结 构 和 用 处 后 ， 下 面 实现 第 一 个 Spring Boot 接口 。 只 要 编写 一 个 类 ， 并 且 完 成 一 
个 方法 即 可 。 
首先 创建 package 为 com.javadevmap.basic.controllers。 然 后 创建 类 BasicController， 类 中 上 
体内 容 如 下 : 
@RestController 
@RequestMapping("/SpringBoot") 
public class BasicController { 
@RequestMapping(value="/hello",method=RequestMethod.GET) 
public String hello() { 
return "******hello Spring Boot*****#"; 


x 


} 
} 
这 样 ， 一 个 Web 接口 即 完 成 了 研发 ， 虽 然 它 不 具备 什么 业务 能 力 ， 但 是 确实 是 免除 了 之 前 
大 量 的 配置 工作 。 通 过 STS H “Run As->Spring Boot APP” 即 可 启动 这 个 工程 。 通 过 浏览 器 访 
问 http://localhost:8080/SpringBoot/hello， 能 看 到 输出 为 “******hello Spring Boot******”, 


7.2 起步 依赖 


目前 ， 仅 仅 创 建 了 一 个 基础 工程 ， 编 号 了 一 段 不 到 十 行 的 代码 ， 就 完成 了 一 个 接口 的 编 
写 ， 这 是 怎么 做 到 的 呢 ? 相对 于 前 面 Spring MVC 的 大 量 配置 工作 ， 上 一 节 的 工程 中 并 没有 做 这 
些 工作 。 那 么 到 底 是 谁 默默 地 做 了 这 些 事情 ? 这 就 是 Spring Boot 的 功劳 。 

上 一 节 工 程 中 使 用 了 Spring Boot 的 起 步 依赖 spring-boot-starter-web， 可 以 说 它 是 Web +H 
关 依 赖 的 合集 ， 仅 使 用 这 一 个 起 步 依赖 就 完成 了 所 有 Web 依赖 包 的 引入 。 查 看 Web 起 步 依赖 的 
pom 文件 ， 可 以 发 现 它 具 体 引 入 的 依赖 2。 

<dependencies> 
<dependency> 


<groupld>org.springframework.boot</groupId> 
<artifactld>spring-boot-starter</artifactld> 
</dependency> 
<dependency> 
<groupld>org.springframework.boot</groupId> 
<artifactld>spring—boot-starter-tomcat</artifactld> 
</dependency> 
<dependency> 
<groupld>org.hibernate</groupld> 
<artifactId>hibernate—validator</artifactld> 


O 手动 分 别 引 入 依赖 时 可 能 会 发 生 版 本 冲突 的 问题 ， 使 用 起 步 依赖 会 保证 所 引入 的 依赖 版 本 之 间 的 可 用 性 。 
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</dependency> 

<dependency> 
<groupId>com.fasterxml.jackson.core</groupId> 
<artifactId>jackson—databind</artifactld> 

</dependency> 

<dependency> 
<groupld>org.springframework</groupId> 
<artifactld>spring-web</artifactld> 

</dependency> 

<dependency> 
<groupId>org.springframework</groupld> 
<artifactld>spring-webmvc</artifactld> 

</dependency> 

</dependencies> 


起 步 依 赖 一 般 以 spring-boot-starter Fk, Spring Boot 的 起 步 依赖 有 很 多 种 ， 后 


用 的 依赖 ， 所 以 这 里 就 不 一 一 介绍 各 种 起 步 依赖 的 能 力 ， 仅 仅 介 绍 起 步 依 赖 所 做 的 事 | 


起 步 依赖 帮助 工程 完成 依赖 包 的 集合 引入 ， 但 是 好 像 距 离 像 之 前 那 相 


差 一 些 ， 那 么 具体 的 属性 配置 工作 就 是 由 Spring Boot 的 自动 配置 能 力 完成 的 。 


7.3 配置 


= 
了 
IH 
c 
mi 
| 

X 
c 


[ 程 内 的 依赖 引 


Spring Boot 的 配置 能 力 非常 灵活 ， 在 什么 都 不 写 的 情况 下 ， 它 会 自动 检测 了 
y 


=] 
用 情况 然后 完成 默认 值 的 配置 工作 。 也 可 以 编写 application 
由 于 Spring Boot 的 配置 优先 级 原则 ， 可 以 用 高 优先 级 的 配 


ml 文件 完成 
ABCA, P 


定义 属性 值 的 配置 。 


| 如 用 启动 


命令 覆盖 自 定义 配置 ， 还 可 以 编写 不 同 环境 的 配置 文件 ， 通 过 Spring Boot 的 多 环境 配置 选择 不 


同 的 环境 局 动 服务 。 


7.3.1 自动 配置 
在 前 面 的 例子 中 ， 启 动 了 一 个 Spring Boot 服务 ， 从 控制 台 可 以 看 多 


| 服务 局 


输出 ， 下 面 截取 部 分 输出 数据 观察 工程 的 启动 流程 和 相应 组 件 的 自动 本 


cu 
if 


Starting SpringBootBasicA pplication... 

Tomcat initialized with port(s): 8080 (http)... 

Starting Servlet Engine: Apache Tomcat/8.5.27... 

Mapping servlet: 'dispatcherServlet' to [/] 

Mapped "{[/SpringBoot/hello],methods=[GET]}" onto public... 

Tomcat started on port(s): 8080 (http)... 

Started SpringBootBasicApplication in 2.334 seconds (JVM running for 3.625) 


这 个 项 目 启 动 的 流程 为 : 
(1) 工程 分 配 进 程 ， 并 且 开 始 启动 。 
(2) 起 步 依 赖 中 的 Tomcat 配置 端口 号 。 
(3) 启动 Servlet 引擎 。 
(4) 配置 Servlet 的 前 端 控制 器 dispatcherServlet。 
(5) 进行 接口 和 方法 的 映射 。 
(6) 通报 Tomcat 容器 启动 完成 。 
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动 过 程 ! 


的 页 面 


(7) 整个 工程 启动 完成 ， 


以 上 仪 用 自动 配置 就 完成 了 一 个 非常 基础 的 Web 服务 的 启动 流程 。 
项 非常 多 ， 只 要 把 起 步 依 赖 加 入 工程 ， 就 执行 自动 配置 。 如 果 对 自动 配置 
以 先 注释 掉 SpringBootBasicApplication 类 中 的 @SpringBootApplication > 
具体 的 变化 。 


7.3.2 ”设置 配置 值 


server.port=18080， 然 后 启动 服务 就 可 以 在 控制 台 看 到 Tomcat 的 端 
started on port(s): 18080 (http))。 这 种 配置 的 格式 很 常见 ， 但 是 本 节 介 
此 种 格式 在 层次 划分 上 更 加 清 


来 ， 
部 分 实例 配置 都 采用 此 利 
在 resources 目录 下 ， 删 除 application.properties 文件 ， 创 建 application.yml 文件 ， 在 文件 中 


在 application.properties 


统计 总 体 耗 时 。 


第 7 章 Spring Boot 


Spring Boot 的 自动 配置 


的 原理 感到 好 奇 ， 可 


文件 中 ， 可 以 设置 服务 启动 的 端口 号 


晰 。 


YAML 语言 是 专门 用 来 书 


已 写 配 置 文件 的 语言 ， 它 的 格式 简洁 ， FHA 


添加 如 下 内 容 。 


解 起 来 就 会 非常 容易 。 


server: 
port: 18088 
tomcat: 
max-threads: 64 


min-spare-threads: 16 


这 时 启动 服务 ， 端 口 变 为 了 18088， 可 见 配置 生效 。 


YAML 语言 的 格式 ， 简 单 概括 起 来 就 是 用 键 值 对 进行 赋值 ， 用 缩 进 表 示 所 属 层级 。 这 样 理 


口 


同一 类 配置 放 到 一 起 便于 阅读 并 且 非 常 美观 。 下 面 简单 演示 YAML 
格式 。 


注解 5， 再 启动 工程 观察 
号 ， 只 要 在 文件 中 添加 


号 改 为 了 18080 (Tomcat 


置 块 能 够 明显 区 分 
的 配置 方式 ， 以 后 的 大 


另 一 种 配置 格式 YAML, 


Spring Boot 服务 的 配置 项 非常 多 ， 所 以 只 能 先 熟悉 一 些 常用 的 配置 项 ， 而 其 他 配置 项 要 在 
实际 项 目 中 进行 摸索 和 理解 。 


如 果 非 常 想 了 解 所 有 的 配置 项 ， 那 么 


本 书 ， 里 面 有 非常 详细 的 配置 项 说 明 。 
7.3.3 ”配置 优先 级 


日 配置 之 间 可 以 根据 人 


件 
数 
带 
认 


执行 “鼠标 右键 单 击 工程 ->Run As->Run Configurations... 


中 的 Program arguments 的 内 容 为 --server.port=18089， 如 图 7-5 所 示 。 


配置 项 只 能 写 在 同一 个 地 方 吗 ? 答案 当然 是 否定 的 。Spring Boot 允许 在 多 处 进行 配置 ， 并 


先 级 进行 覆盖 。 下 面 演示 一 种 命令 行 启 动 服务 的 配置 方式 。 


”进入 配置 页 面 ， 设 置 


E 荐 《Spring Boot 实战 》 这 


Arguments 


点 击 下 方 的 Run， 启 动 的 工程 端口 为 ，Tomcat started on port(s): 18089 (http). FY ILE yml 3¢ 


中 的 设置 被 新 设置 所 覆盖 。 


(如 本 例 )、java:comp/env 里 的 JNDI 属性 、JVM 系统 属性 、 操 作 系 统 环境 变量 、 
HE5 


Spring Boot 的 属性 源 有 很 多 ， 优 先 级 


random.* 前 级 的 属性 、 应 用 程序 外 的 配置 文件 (application.yml)、 


=] 


BPE. 


O 它 由 以 下 几 个 注解 组 成 ， @SpringBootConfiguration 、@EnableAutoConfiguration 、 


Spring Boot 的 扫描 、 自 动 配置 等 能 


应 月 


高 到 低 分 别 是 : 命令 行 参 


随机 生成 的 


内 的 本 


@ComponentScan ， 这 三 


LEH BK 


个 合 起 来 形成 了 
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二 Run Configurations 


Create, manage, and run configurations 


type filte 


r text 


加 ThreadLoaclDer ^ 
回 ThreadPool 
O ThreadReadWri 
加 ThreadRunnablh 
回 ThreadWaitNot 
m Tiger 

Ju JUnit 

Ju JUnit Plug-in Test 

æ Launch Group 


m2 M 


aven Build 


® Node.js Applicatiol 
@® OSGi Framework 
Q’ Pivotal tc Server 


< 


®© Spring Boot App 


© SpringBootBasi 
Q Spring Boot Devto 
Jy Task Context Test 
x% XSL S 


< 


Filter matı 


® 


一 般 来 讲 需 要 研发 人 员 编 写 的 是 配置 文人 


> 
ched 62 of 62 items 


影响 ， 需 要 注意 。 命 令 行 属 性 的 作用 一 般 是 临 


7.3.4 ”多 环境 配置 


Name: |SpringBootBasic - SpringBootBasicApplication 


Program arguments: 


® Spring Boot | (= Arguments » mi JRE | 0 Classpath | By Source | 国 Environment| ”; 


--server.port=18089 


VM arguments: 


Working directory: 


Ka 


© Default: ${workspace_loc:SpringBootBasic 
© Other: 


启动 配置 


TT 


里 的 属性 ， 而 系统 和 环境 里 的 属性 
时 配置 或 者 做 配置 选择 。 


这 中 ， 服 务 所 使 用 的 端 


(1) 同一 文件 不 同 profile 


TT 


把 不 同 的 环境 配置 号 入 同一 个 文 从 


Application.yml 文 从 


server: 


修改 如 下 : 


port: 18088 


tomcat: 


max-threads: 64 


min-spare-threads: 16 


spring: 


profiles: dev 


server: 


port: 18001 


spring: 


profiles: prod 
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两 种 多 环境 配置 


日 于 两 利 
方法 。 


在 研发 过 程 中 ， 一 般 会 面临 最 少 两 个 环境 ， 一 个 是 研发 和 测试 的 环境 ， 称 为 功能 环境 ， 男 
一 个 是 实际 业务 运行 的 环境 ， 称 为 生产 环境 。 在 这 两 个 环 ] 
数据 库 地 址 可 能 是 不 同 的 ， 这 就 需要 有 两 套 配 置 应 月 
进行 多 环境 的 部 署 工 作 。 这 里 介 


， 所 连接 的 


H Spring Boot 可 以 方便 地 


然后 通过 启动 命令 选择 不 同 的 环境 进行 启动 。 


server: 
port: 18002 


在 这 里 ， 
用 的 配置 五 


少 某 些 默 认 环 境 已 经 
的 配置 项 ， 则 覆盖 默认 环 ] 


不 同 的 环境 用 “---” 隐 


配置 的 配置 项 ， 贝 


境 。 进 入 局 动 配置 


Create, manage, and run configurations 


IEA 


type filter text 


BF XAA 


上 使 


] profiles 设置 环境 名 称 ， 一 
可 以 放 在 默认 环境 中 。 在 启动 工程 时 ， 选 择 不 同 的 环境 即 可 。 如 果 选 择 的 环境 中 缺 
用 默认 环境 的 配置 ， 如 果 选 择 的 环境 中 包含 默认 环境 
页 ， 在 Profile 中 填 入 环境 名 称 ?。 如 图 


第 7 章 Spring Boot 


些 通 


7-6 所 示 。 


Q 


Name: | Spring 


BootBasic - SpringBootBasicApplication 


© Spring Boot». = Arguments | BÀ JRE | “> Classpath | By Source | 国 Environment] ”; 


回 ThreadLoaclDer ^ 


[en] 
回 ThreadPool 
回 ThreadReadWri 
加 ThreadRunnabl: 
加 ThreadWaitNot 
回 Tiger 
Ju JUnit 
Je JUnit Plug-in Test 
E Launch Group 
m2 Maven Build 
M Node.js Applicatiol 
$ OSGi Framework 
@ Pivotal tc Server 
v 图 Spring Boot App 
© SpringBootBasi 
Q Spring Boot Devto 
Jy Task Context Test 
XSL 


< > 


Filter matched 62 of 62 items 


® 


这 样 ， 通 过 选择 不 同 的 profile， 即 可 根据 不 同 的 环境 配置 启 


(2) 不 同文 件 环境 配置 
通过 创建 不 同文 件 
在 resources 文件 


v 


Project 
Main type 


Profile 


Fast startup 


Enable JMX 


回 


z 


Enable debug output 


Enable Life Cycle Management. Termination timeout (ms): | 15000 


SpringBootBasic v 


com,javadevmap.basic.SpringBootBasicApplication 


| prod 


Hide from Boot Dash 


ANSI console output 


Port: |0 


Enable Live Bean support. 


Override properties: 


property 


value 


Ka 


7-6 多 环境 选择 


3J 


DI 


£o 


v 


名 的 文件 ， 达 到 多 环境 配置 的 目的 。 
夹 中 创建 两 个 文件 ， 
dev.yml 和 application-prod.yml， 在 文件 中 设置 自己 的 


分 别 为 application- 


RHE, JAZ) 


时 也 可 以 通过 profile 选择 个 同 的 环 踪 进 生 局 动 。 


application- M EP EE Z 
profile 就 是 dev 和 prod。 
作者 推荐 使 用 多 文件 


交 冲 突 等 问题 。 
自 定 义 类 的 注 人 
前 面 已 经 


过 Spring Boot 管理 


En 9 


7.3.5 


Al AY 44 =F 


的 配置 方式 ， 这 种 方式 可 以 


FT Spring Boot 


e? 


Profile 名 称 为 
7-7 所 示 ， 文 件 的 


Z] 


如 


HAH 


(1) 首先 引入 pom 文件 依赖 : 


带 组 件 的 配置 方法 ， 那 么 如 
就 像 通过 Spring 管 


ANTS 


管理 一 样 ， 应 该 怎么 编写 呢 ? 


O 记得 去 掉 之 前 在 Arguments 中 设置 的 端 


号 ， 和 否则 配置 文件 中 的 值 


会 被 覆盖 ， 


使 配置 间 的 分 隔 更 加 明确 ， 


自 定义 一 个 类 ， 


Search... 


Close 


@ src/main/resources 
© static 
© templates 
#3 application-dev.yml 
B application-prod.yml 
Æ application.yml 


图 7-7 多 配置 文件 


并 且 


避免 了 提 


并 且 和 希望 通 
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<dependency> 
<groupld>org.springframework.boot</groupId> 
<artifactId>spring—boot-configuration-processor</artifactId> 
<optional>true</optional> 

</dependency> 


(2) 编写 自 定义 的 类 ， 这 里 使 用 一 个 抽象 基 类 和 两 个 派生 类 (后面 会 演示 两 种 加 载 方法 ): 


public abstract class IocAnimal { 


private int weight; 
private String desc; 


public int getWeight() { 
return weight; 

} 

public void setWeight(int weight) { 
this.weight = weight; 

} 

public String getDesc() { 
return desc; 

} 

public void setDesc(String desc) { 
this.desc = desc; 


@Component 


iocfish") 
public class IocFish extends locAnimal { 


@ConfigurationProperties(prefix: 


@Component 


@ConfigurationProperties(prefix="ioctiger") 
public class IocTiger extends IocAnimal { 


} 
(3) 编写 yml 配置 文件 : 


ioctiger: 
weight: 500 
desc: i am tiger 


iocfish: 
weight: 500 
desc: i am fish 


(4) 在 Controller 类 中 注 
@RestController 
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5% - 立 - 


镍 7 证 


@RequestMapping("/SpringBoot") 


public class BasicController { 


} 


代码 中 使 用 了 两 种 注入 方式 ， 两 种 方式 的 原理 在 第 5 革 已 经 有 了 详细 的 介绍 ， 


@Autowired 
private IocAnimal iocFish; 


@Autowired 
@Qualifier("iocTiger") 


private IocAnimal iocAnimal; 


@RequestMapping(value="/tiger", method=RequestMethod.GET) 
public IocAnimal getTiger() { 
return iocAnimal; 


} 


@RequestMapping(value="/fish",method=RequestMethod.GET) 
public IocAnimal getFish() { 
return iocFish; 


} 


自 定 义 类 在 Spring Boot 工程 中 的 创建 及 注入 方法 。 


7.4 使 用 Thymeleaf 构建 页 面 


通过 前 面 的 学 习 ， 读 者 对 Spring Boot 的 主要 特性 有 了 较 多 的 认识 。 下 面 


Spring Boot 


这 里 仅 演 示 


可 以 基于 Spring 


Boot 工程 实现 自己 的 业务 站 点 。 最 基础 的 业务 站 点 需要 有 页 面 和 数据 存储 ， 昌 然 本 书 不 会 把 页 


面部 分 作为 重点 ， 但 是 绘制 简单 页 面 可 以 为 后 全 开发 带 来 一 些 额 外 的 成 就 感 ， 毕 竞 
格式 的 数据 看 起 来 没有 页 面 那 么 美观 。 
7.4.1 Thymeleaf 基本 使 用 


Thymeleaf 是 一 款 用 于 泻 染 XML/XHTML/HTMLS 内 容 的 模板 引擎 ， 也 是 Spring Boot 官方 
推荐 使 用 的 模板 引擎 ， 可 以 用 它 替 代 ISP 进行 页 面 绘制 。 


(1) 添加 依赖 
可 以 在 STS 4 
键 单 击 ->Spring->Edit Starters” 即 可 进入 如 图 7-8 所 示 页 面 ， 在 页 面 9 


Pp 选择 pom 文件 ， 然 后 进入 pom 文件 的 Dependencies 选项 栏 ， 执 行 “鼠标 右 


只 返回 JSON 


的 依赖 ， 而 不 必 使 用 pom 的 文本 编辑 输入 依赖 项 。 


依赖 : 


<dependency> 


<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-thymeleaf</artifactId> 


</dependency> 


P 可 以 方便 地 查找 想 要 使 用 


在 搜索 栏 中 输入 thyme 就 可 以 搜 出 Thymeleaf 依赖 ， 选 择 即 可 。 在 pom 文件 中 会 增加 如 下 
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Edit Spring Boot Starters 


Service URL http://start.spring.io 


Frequently Used 


M Configuration Processor [V] Web 


Available: Selected: 


| | X Configuration Processor 


X Web 
> Azure a 


> Cloud AWS 

> Cloud Circuit Breaker 
> Cloud Config 

+ Cloud Contract 

+ Cloud Core 

> Cloud Discovery 
+ Cloud Messaging 
+ Cloud Routing 

> Cloud Tracing 

b Core 

+ 1/0 

> Messaging 

> NoSQL 


+O 。 
ig v Make Default Clear Selection 


Cancel 
图 7-8 依赖 选择 页 面 


(2) 添加 模板 页 面 
在 templates 目录 下 ， 添 加 welcome.html 文件 ， 完 成 一 个 最 简单 的 


<html xmlns:th="http://www.thymeleaf.org"> 
<head> 

<title>welcome spring boot</title> 

</head> 

<body> 

Welcome Spring Boot! 

</body> 

</html> 


(3) 添加 Controller 
在 controllers 包 下 新 建 一 个 类 PageController， 目 前 这 个 类 仅 实 现 一 个 方法 ， 这 个 方法 的 目 
的 是 对 访问 路 径 和 模版 页 面 进行 映射 。 
@Controller 
@RequestMapping(value="/page") 
public class PageController { 
@RequestMapping(value="/welcome") 
public ModelAndView welcome() { 


ModelAndView modelAndView = new ModelAndView("welcome"); 
return modelAndView; 


= 


面 模板 。 


j 


注意 ，PageController 类 中 使 用 @Controller 作为 注解 ， 方 法 返回 的 是 ModelAndView 类 型 。 
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a 


通过 浏 


“Welcome Spring Boot!” 的 输出 。 


第 7 章 Spring Boot 


览 器 访问 http://localhost:18088/page/welcome 地 址 ， 可 以 查看 这 个 页 面 ， 页 面 上 有 


(4) 添加 静态 资源 
前 面 已 经 通过 Spring Boot 完成 了 一 个 简单 的 页 面 ， 但 是 这 个 页 面 确实 有 些 太 简单 了 ， 可 以 


稍微 对 页 面 进行 优化 ， 添 加 一 些 静 态 图 片 ， 让 它 稍微 美 观 一 些 。 在 static 中 添加 静态 资源 


spring_boot.jpg 文件 ， 然 后 修改 welcome.html 文件 ， 更 改 样式 和 插入 图 片 。 


<html xmlns:th="http://www.thymeleaf.org"> 

<head> 

<title>welcome spring boot</title> 

</head> 

<body> 

<div style="width:600px;border: 1 px solid black"> 

<img style="height:200px;margin:0 auto;display:block" alt="" src="/spring_boot.jpg"></img> 

<div> 

<label — style="font-size:48px;display:block;width:100%;text-align:center" th:text=""Welcome Spring 


Boot!""></label> 


通 


7.4.2 


</div> 
</div> 
</body> 
</html> 
过 浏览 器 访问 此 网 址 ， 可 以 看 到 如 图 7-9 所 示 页 面 2。 
< GZ |© localhost:18088/page/welcome 
Welcome Spring Boot! 
图 7-9 页面 运 行 效果 
添加 页 面 多 得 


现在 虽然 已 经 可 以 绘制 简单 的 页 面 了 ， 但 是 这 种 页 面 明显 与 实现 基本 的 业务 逻辑 相差 其 


远 。 下 面 给 程序 添加 页 面 和 数据 交互 的 逻辑 ， 让 页 面 变 得 更 有 意义 。 


设计 一 个 页 面 ， 可 以 通过 输入 框 输入 用 户 信息 ， 然 后 提交 给 后 台 程 序 。 


( 


1) 添加 输入 页 面 模板 


添加 页 面 模板 createuserhtml， 把 页 面 输入 数据 的 部 分 放 入 form 中 ， 并 且 通 过 action 标记 数 


据 处 到 


的 方法 ， 这 个 方法 会 在 submit 时 被 调用 。 


© 


实现 动态 更 新 程序 的 目的 ， 而 不 必 不 断 手 动 启 妃 


民 务 。 


在 调试 程序 时 ， 可 能 针对 某 些 修改 要 重启 程序 ， 这 会 对 研发 速度 造成 一 定 的 影响 ， 可 以 通过 引入 spring-boot-devtools 依赖 从 而 
J 
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<html xmlns:th="http://www.thymeleaf.org"> 

<head> 

<title>create user</title> 

<meta http~equiv="Content-Type" content="text/html; charset=UTF-8" /> 


</head> 
<body> 
<div> 
<label style="font-size: 18px" th:text=" 创 建 用 户 "></label> 
</div> 
<form th:action="(@ {/page/save}" method="post" th:object="$ {user}" style="width:600px"> 
<fieldset> 
<p> 
<label style="font-size: 18px" th:text=" 名 字 : "></label> <input 
type="text" id="name" name="name" tabindex="1"></input> 
</p> 
<p> 
<label style="font-size: 18px" th:tex{=" 年 龄 : "></label> <input 
type="text" id="age" name="age" tabindex="2"></input> 
</p> 
<p> 
<label style="font-size: 18px" th:text=" 电 话 号 码 : "></label> <input 
type="text" id="phoneNum" name="phoneNum" tabindex="3"></input> 
</p> 
<p> 
<label style="font-size: 18px" th:text="{EHE: '"></label> <input 
type="text" id="address" name="address" tabindex="4"></input> 
</p> 
<p id="buttons"> 
<input id="submit" type="submit" tabindex="5" value=" 创 建 "></input> <input 
id="reset" type="reset" tabindex="6" value=" 取 消 "></input> 
</p> 
</fieldset> 
</form> 
</body> 
</html> 


(2) 添加 页 面 映射 Controller 类 方法 


@RequestMapping(value="/createuser") 

public ModelAndView createUser() { 
ModelAndView modelAndView = new ModelAndView("createuser"); 
return modelAndView; 


} 


(3) 添加 页 面 数据 模型 
此 数据 结构 用 来 承载 页 面 输入 的 数据 。 


public class User { 
private int id; 
private String name; 
private int age; 
private String phoneNum; 
private String address; 
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@Override 
public String toString() { 
return "name="+ name + ";age = " + age + "jphoneNum =" + phoneNum + ";address = " + address; 


} 

} 
(4) 页 面 展示 
通过 以 上 的 配置 ， 可 以 根据 模板 映射 和 模板 页 面 的 实现 ， 在 浏览 器 中 显示 实际 的 前 端 页 

面 。 如 图 7-10 所 示 。 
(5) 添加 数据 交互 
根据 上 面 的 页 面 进行 输入 ， 但 是 输入 后 的 数据 由 谁 来 承接 呢 ? 这 就 需要 提供 一 个 接口 ， 用 
来 承接 页 面 数据 。 
@RequestMapping(value="/save") 
public ModelAndView save(@ModelAttribute User user) { 
ModelAndView modelAndView = new ModelAndView("save"); 


modelAndView.addObject("info", user.toString()); 
return modelAndView; 


} 
以 上 为 承接 页 面 数据 的 接口 。 然 后 编写 一 个 save.html 模板 页 面 把 toString 生成 的 数据 显示 
出 来 ， 具 体 如 下 。 


<html xmlns:th="http://www.thymeleaf.org"> 

<head> 

<title>welcome spring boot</title> 

<meta http~equiv="Content-Type" content="text/html; charset=UTF-8" /> 
</head> 

<body> 

<label style="font-size:18px;display:block" th:text="$ {info}"></label> 
</body> 

</html> 


(6) 页 面 显 示 
在 创建 用 户 的 页 面 输入 一 些 User 信息 ， 如 图 7-11 所 示 ， 然 后 观察 save 页 面 的 显示 。 


© 一 口 
= Œ © localhost:18( age/createuser Oe 5 
€ CŒ | © localhost:18088/page/createuser fj i 

pi 创建 用 

名 字 : 名 字 : [SpringBoot 

年 龄 : eH. 

电话 号 码 : 电话 号 码 : i2345678901 | 

住址 : 住址 : [Sprint | 

创建 || 取消 CAE 


图 7-10 ”用户 信 息 输入 页 面 图 7-11 输入 用 户 信 息 
点 击 “ 创 建 ” 后 ， 显 示 的 页 面 内 容 如 图 7-12 所 示 。 
现在 虽然 可 以 在 后 台 程 序 接收 前 台 页 面 的 输入 了 ， 但 是 这 么 直 白 地 显示 出 来 好 像 也 没有 什么 

意义 ， 而 且 一 旦 程序 退出 ， 之 前 输入 的 数据 也 会 丢失 ， 所 以 需要 把 数据 持久 化 。 


163 


Java 服务 端 研 发 知识 图 谱 


€ CŒ |© localhost:18088 


name = SpringBoot;age = 4phoneNum = 12345678901;address = Spring 社区 


图 7-12 保存 结果 页 面 


7.5 使 用 JPA 构建 持久 化 存储 


Spring Data JPA 是 Spring 在 ORMS 框 架 、JPAS 规 范 的 基础 上 封装 的 一 套 JPA 应 用 框架 ， 可 
使 开发 者 用 极 简 的 代码 实现 对 数据 的 访问 和 操作 。 

本 节 将 要 用 JPA 连接 一 个 MySQL 数据 库 ， 如 果 读 者 之 前 对 数据 库 一 点 都 不 了 解 ， 那 么 
使 用 IPA 倒是 非常 简单 的 ， 就 像 给 方法 起 一 些 有 意义 的 名 字 ， 就 可 以 操作 数据 库 了 ; 如 果 读 
者 习惯 了 用 SQL 的 方式 使 用 数据 库 ， 那 么 反倒 可 能 造成 一 些 影 响 ，JPA 的 写法 还 是 要 适应 一 
段 时 间 的 。 


7.5.1 JPA 基本 使 用 


这 里 用 最 原始 的 JPA 来 实现 数据 操作 。 可 以 把 业务 数据 存 入 数据 库 中 ， 并 且 在 需要 的 时 候 
取出 。 

(1) 添加 依赖 
在 pom 文件 中 引入 如 下 依赖 ， 因 为 要 连接 MySQL 数据 库 ， 所 以 除了 引入 JPA 依赖 还 要 引 
入 MySQL 连接 的 依赖 。 


<dependency> 
<groupld>org.springframework.boot</groupId> 
<artifactld>spring—boot-starter-data—jpa</artifactld> 

</dependency> 

<dependency> 
<groupId>mysql</groupId> 
<artifactId>mysql-connector—java</artifactld> 
<scope>runtime</scope> 

</dependency> 


(2) 添加 数据 库 配置 


Spring: 

datasource: 
driver-class-name: com.mysql.jdbc.Driver 
url: jdbc:mysql://localhost:3306/javadevmap?characterEncoding=utf-8 
username: root 
password: mypass 

jpa: 
database-platform: org.hibernate.dialect. MySQLS5Dialect 
hibernate: 

ddl—auto: update 


O ORM BIXTR AWN CRIA: Object Relational Mapping, fij#K ORM, H O/RM, EÈ O/R mapping) ， 是 一 种 程序 技术 ， 用 于 

实现 面向 对 象 编程 语言 里 不 同类 型 系统 的 数据 之 间 的 转换 。 

© JPA 是 Java Persistence API 的 简称 ， 中 文 名 为 Java 持久 层 API， 通 过 IDK 5.0 注解 或 XML 描述 “对 象 一 关系 表 ” 的 映射 关 

系 ， 并 将 运行 期 的 实体 对 象 持久 化 到 数据 库 中 。 
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在 上 面 的 配置 中 ， 对 datasource 设置 了 驱动 com.mysql.jdbc.Driver， 并 日 通过 url 设置 了 数 
据 库 的 地 址 ， 通 过 username 和 password 设置 数据 库 的 账号 和 密码 。 
对 jpa 设置 了 目标 数据 库 ， 并 且 设 置 了 自动 更 新 库 表 。 如 果 读 者 不 熟悉 JPA， 那 么 自动 更 新 
这 个 设置 非常 重要 ， 当 数据 库 中 不 存在 表 时 它 会 帮 你 创建 ， 当 你 添加 映射 类 的 字段 时 它 会 帮 你 
人 
JPA 中 的 表 的 字段 匹配 万 一 出 现 问题 会 导致 JPA 无 法 使 用 表 ， 排 查 这 个 问题 会 比较 困难 。 
G) 添加 实体 映射 类 
使 用 之 前 的 User 类 ， 只 是 是 把 这 个 类 通过 注解 标记 ， 使 之 成 为 实体 映射 类 ， 这 样 JPA 就 可 以 
通过 这 个 类 去 创建 数据 库 表 。 
@Entity 
@Table(name="User") 


public class User { 
CId 
@GeneratedValue(strategy=GenerationType.IDENTITY) 
private int id; 
private String name; 
private int age; 
private String phoneNum; 
private String address; 


Ms 


} 


通过 它 ，JPA 会 在 数据 库 中 生成 一 个 user K, FHA id 为 自 增 的 主键 。 
(4) 定义 数据 访问 接 
使 用 原生 的 数据 库 访 问 接口 的 方法 ， 所 以 只 要 用 一 个 接口 类 继承 JpaRepository 就 可 以 了 。 


public interface UserRepository extends JpaRepository<User, Integer>{ 


} 


这 种 写法 还 真 的 适合 同人 ， 因 为 就 是 什么 都 没 写 。 可 以 向 类 中 添加 自 定 义 的 方法 ， 从 而 实 
现 不 同 的 能 

(5) 实现 存储 和 展示 逻辑 

下 面 ， 要 做 的 事情 就 是 把 页 面 传 过 来 的 数据 放 入 数据 库 中 存储 ， 并 且 从 数据 库 中 取 部 分 数 
据 用 于 展示 。 
新 建 一 个 service 接口 类 和 实现 类 ， 用 于 业务 逻辑 的 实现 。 这 个 类 实现 了 两 个 方法 ， 一 个 调 
用 repository 把 数据 存 入 数据 库 ， 另 一 个 倒序 取出 数据 库 中 的 最 后 10 条 数据 ， 方 法 中 用 到 了 
PageRequest 的 分 页 能 力 ， 设 置 的 是 每 页 显示 10 条 数据 ， 显 示 第 一 页 ， 通 过 Sort 实现 倒序 。 

public interface UserService { 


public void add(User user); 
public List<User> getList(); 


} 


@Service 

public class UserServiceImpl implements UserService{ 
@Autowired 
private UserRepository repository; 
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public void add(User user) { 
repository.save(user); 


j 


public List<User> getList() { 
Sort sort = new Sort(Sort.Direction.DESC, "id"); 
return repository.findAll(new PageRequest(0, 10, sort)).getContent(); 


} 
} 
在 Controller 类 中 注入 service 类 实例 ， 进 行业 务 逻 辑 操 作 ， 并 且 把 要 显示 的 数据 传 入 页 面 。 
@Autowired 


private UserService userService; 

@RequestMapping(value="/save") 

public ModelAndView save(@ModelAttribute User user) { 
userService.add(user); 
List<User> list = userService.getList(); 
ModelAndView modelAndView = new ModelAndView("save"); 
modelAndView.addObject("list", list); 
return modelAndView; 


} 
修改 save.html 页 面 ， 用 于 显示 用 户 list。 


<html xmlns:th="http://www.thymeleaf.org"> 
<head> 
<style> 
table { 
border-collapse: collapse; 
border-spacing: 0; 
border-left: 1px solid #888; 
border-top: 1px solid #888; 
background: #efefef; 


} 

th, td { 
border-right: 1px solid #888; 
border-bottom: 1px solid #888; 
padding: 5px 15px; 

} 

th { 
font-weight: bold; 
background: #ccc; 

} 

</style> 


<title>welcome spring boot</title> 
<meta http~equiv="Content-Type" content="text/html; charset=UTF-8" /> 
</head> 
<body> 
<div style="width: 600px"> 
<label style="font-size: 18px" th:text=" 用 户 列表 : "></label> 
</div> 
<div style="width: 600px"> 
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<table style="width: 100%"> 
<tr> 


<td> 编 号 </td> 
<td> 名 字 </td> 
<td> 年 龄 </td> 
<td> 手 机 号 </td> 
<td> 住 址 </td> 


</tr> 
<tr th:each="user : $ {list} "> 


<td th:text="$ {user.id} "></td> 

<td th:text="$ {user.name} "></td> 

<td th:text="$ {user.age}"></td> 

<td th:text="$ {user.phoneNum}"></td> 
<td th:text="$ {user.address}"></td> 


</tr> 


</table> 
</div> 


<label style="font-size: 18px; display: block" th:text="$ {info}"></label> 


</body> 
</html> 


(6) 显示 效果 如 图 7-13 所 示 。 


€ GG | © localhost:18088/page/save 
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目前 的 Spring Boot 工程 已 经 实现 了 前 后 台 


然 这 个 功能 看 起 来 有 些 


用 户 列 表 : 

编号 | 名 字 as 手机 号 | 住址 
12 | mybatis 8 | 1234567890 | EIR 
11 | spring boot 8 234567890 | 地 球 
10 spring MVC 18 12345678901 | 地 球 
9 | spring 8 234567890 | 地 球 
8 maven 8 234567890 | 地 球 
7 svn 18 2345678901 | 地 球 
6 git | 18 2345678901 | 地 球 
5 linux 8 234567890 | 地 球 
4 C++ 8 1234567890 | 地 球 
3 java 18 12345678901 | 地 球 


图 7-13 数据 保存 列表 


的 打通 ， 前 台 输 入 数据 ， 后 合 存储 数据 。 虽 


简单 ， 但 确实 是 一 个 项 目的 最 基础 和 核心 的 内 容 ， 一 个 大 的 平台 也 


是 从 这 些小 功能 开始 慢 慢 丰富 和 发 展 起 来 的 。 如 果 想 了 解 更 多 ， 最 好 的 学 习 办 法 就 是 在 


实际 项 目 中 接触 更 多 的 内 容 ， 解 决 更 多 的 问题 ， 想 更 多 的 解决 方案 。 
7.5.2 EX JPA 扩展 接口 


当 使 用 JPA 时 ， 只 


要 继承 JpaRepository， 就 继承 了 一 些 默认 的 方法 ， 主 要 包含 如 下 几 类 : 


delete、find、save、count、exists。 上 例 中 就 使 用 了 save 和 find 方法 来 实现 业务 逻辑 ， 但 是 这 些 


默认 方法 还 不 能 覆盖 所 有 的 SQL 操作 ， 需 要 手动 扩展 方法 。 


扩展 使 用 方法 时 ， 就 好 像 用 英文 直译 要 做 的 事情 一 样 来 定义 方法 名 ， 例 如 想 通 过 id 来 查找 
某 条 数据 ， 只 要 定义 一 个 方法 findById， 就 具备 了 通过 id 查找 的 能 
中 定义 儿 个 方法 来 扩充 对 数据 库 操作 的 能 力 。 


。 下 面 在 UserRepository 
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public interface UserRepository extends JpaRepository<User, Integer>{ 
public User findById(int id); 
public User findByName(String name); 
public List<User> findByAgeBetween(int start,int end); 
public List<User> findByAgeLessThan(int age); 
j 


如 上 面 所 写 ， 只 要 把 想 做 的 事 按照 IPA 的 规则 命名 一 个 方法 ， 即 完成 了 数据 库 操 作 语 句 的 
建立 。 具 体 的 JPA 规则 见 表 7-1。 


表 7-1 JPA 规则 


关 键 F 示 Fil JPQL 代码 
And findByLastnameAndFirstname ”WwWhere x.lastname = ?1 and x.firstname = ?2 
Or findByLastnameOrFirstname * where x.lastname = ?1 or x.firstname = ?2 
Is,Equals ee ee, eee » where x firstname = 1 
Between findByStartDateBetween * where x.startDate between ?1 and ?2 
LessThan findByAgeLessThan * where x.age <?1 
LessThanEqual findByAgeLessThanEqual +++ where x.age <= ?1 
GreaterThan findByAgeGreaterThan * where x.age > ?1 
GreaterThanEqual findByAgeGreaterThanEqual … where x.age >= ?1 
After findByStartDateA fter … where x.startDate > ?1 
Before findByStartDateBefore … where x.startDate < ?1 
IsNull findByAgelsNull … where x.age is null 
IsNotNull,NotNull findByAge(Is)NotNull … where x.age not null 
Like findByFirstnameLike … where x.firstname like ?1 
NotLike findByFirstnameNotLike … where x.firstname not like ?1 
StartingWith findByFirstnameStarting With pices x.firstname like ?1(parameter bound with 
EndingWith findByFirstnameEndingWith ie Whee x.firstname like ?1(parameter bound with 
Containing findByFirstnameContaining … where x.firstname like ?1 (parameter bound wrapped in %) 
OrderBy findByAgeOrderByLastnameDesc … where x.age = ?1 order by x.lastname desc 
Not findByLastnameNot … where x.lastname > ?1 
In findByAgeIn(Collection ages) … where x.age in ?1 
NotIn findByAgeNotIn(Collection age) +++ where x.age not in ?1 
TRUE findByActiveTrue() * where x.active = true 
FALSE findByActiveFalse() + where x.active = false 
IgnoreCase findByFirstnamelgnoreCase * where UPPER(x.firstame) = UPPER(?1) 


使 用 以 上 规则 ， 就 可 以 自由 组 装 接口 方法 来 扩展 数据 库 操作 能 


7.6 Actuator 


Spring Boot Actuator 提供 了 众多 Web 端点 ， 可 以 通过 端点 了 解 服务 内 部 的 运行 情 
Actuator 提供 的 端点 见 表 7-2。 
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表 7-2 Actuator 端点 


HTTP 方法 路 径 描述 鉴 权 
GET /autoconfig 查看 自动 配置 的 使 用 情况 TRUE 
GET /configprops 查看 配置 属性 ， 包 括 默 认 配 置 TRUE 
GET /beans 查看 bean 及 其 关系 列表 TRUE 
GET /dump 打印 线程 栈 TRUE 
GET /env 查看 所 有 环境 变量 TRUE 
GET /env/{name} 查看 具体 变量 值 TRUE 
GET /health 查看 应 用 健康 指标 FALSE 
GET /info 查看 应 用 信息 FALSE 
GET /mappings 查看 所 有 url 映射 TRUE 
GET /metrics 查看 应 用 基本 指标 TRUE 
GET /metrics/{name} 查看 具体 指标 TRUE 
POST /shutdown 关闭 应 TRUE 
GET /trace 查看 基本 追踪 信息 TRUE 
按照 Spring Boot 的 一 贯 风格 ， 只 要 引入 pom 依赖 ， 再 进行 一 些 简单 的 配置 ， 就 可 以 使 用 某 


组 件 了 ，Actuator 也 是 这 样 。 


7.6.1 Actuator 的 基本 使 用 


C1) 添加 依赖 
<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-actuator</artifactId> 
</dependency> 
现在 访问 程序 的 http://localhost:18088/health 端点 ， 可 以 得 到 如 下 信息 : 
{"status":"UP","diskSpace": {"status":"UP", "total": 195696783360," free":145456672768,"threshold": 10485760 
},"db": {"status":"UP","database":"MySQL","hello":1}} 
WU ER Wi la] http:/ocalhost:18088/metricss K/E AF AWE? 其 实 是 不 可 访问 ， 这 就 是 上 表 中 鉴 权 
的 意思 ， 这 个 端点 是 受 保护 的 ， 如 果 想 直接 访问 可 以 先 关 闭 端点 安全 能 力 。 
(2) 关闭 安全 认证 
在 ym 文件 中 添加 如 下 设置 ， 即 可 关闭 端点 的 安全 认证 。 
management: 
security: 
enabled: false 
这 样 访问 metrics 端点 就 可 以 得 到 数据 。 
(3) 使 用 端点 关闭 程序 
通过 yml 文件 的 配置 ， 开 启 shutdown 端点 。 
endpoints: 


shutdown: 
enabled: true 
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使 用 shutdown 端点 可 以 关闭 程序 ， 它 与 其 他 端点 不 同 的 地 方 


是 它 


是 POST 类 型 的 请 求 ， 使 


用 Postman 工具 提交 一 个 POST 请 求 到 端点 ， 如 图 7-14 所 示 。 
POST ycalhost:18( sh Par Send ~ 
Headers 
Body A s: 200 Ok Time: 1713 ms 
etty = 
j“ "message": "Shutting r e 
} 
图 7-14 shutdown 请 求 展 示 
执行 后 可 以 得 到 如 下 输出 结果 : 
{"message":"Shutting down, bye..."} 
7.6.2 ”端点 的 保护 
如 果 程 序 运行 在 网 络 中 ， 那 么 把 端点 暴露 出 去 是 很 危险 的 ， 所 以 应 该 想 一 些 办 法 尽量 不 要 
让 其 他 人 调用 到 程序 的 端点 。 
(1) 隐藏 端点 
可 以 用 一 个 简单 的 办 法 ， 既 不 开启 安全 认证 ， 又 能 对 shutdown 端点 适当 隐藏 。 通 过 修改 
shutdown 端点 的 id， 把 端点 的 调用 指向 另 一 个 路 径 ， 这 样 可 以 避免 熟悉 Actuator 的 人 调用 
shutdown 端点 。 
endpoints: 
shutdown: 
enabled: true 
id: kill 
(2) 端点 安全 认证 
可 以 为 端点 设置 一 个 路 径 ， 然 后 对 这 个 路 径 进行 加 密 保护 ， 这 样 端 点 就 安全 多 了 。 
添加 依赖 : 
<dependency> 


<groupId>org.Springframework.boot</groupId> 
<artifactId>spring-boot-starter-security</artifactId> 


</dependency> 
修改 端点 配置 : 


management: 
context-path: /admin 
security: 
enabled: true 
security: 
user: 
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name: admin 
password: mypass 
basic: 
enabled: true 
path: /admin 
endpoints: 
shutdown: 
enabled: true 
id: kill 
sensitive: true 
metrics: 
enabled: true 
sensitive: true 


I 


端点 的 访问 路 径 通过 context-path 设置 为 /admin 根 路 径 ， 这 样 访问 端点 时 前 面 要 加 上 此 路 
径 。 打 开 安 全 认证 组 件 ， 并 且 设 置 账号 密码 后 ， 访 问 /admin 路 径 时 都 需要 输入 账号 信息 ， 所 以 
端点 安全 多 了 。 


7.7 部署 


目前 ， 调 试 Spring Boot 程序 时 ， 都 是 在 DE 工具 中 ， 如 果 程 序 编写 完毕 需要 上 线 运 行 ， 表 
定 不 是 在 IDE 中 运行 ， 而 是 运行 在 服务 器 中 。 在 服务 器 中 运行 Spring Boot 程序 的 方法 非常 简 
单 ， 按 照 以 下 流程 操作 即 可 。 

(1) 程序 打包 

执行 “鼠标 右键 单 击 工程 ->Run As->Maven install”， 这 样 程 序 会 通过 Maven 打包 成 一 个 Jar 
包 。Jar 包 名 字 为 SpringBootBasic-0.0.1-SNAPSHOTjar。 如 果 成 功 打包 会 有 如 下 输出 。 
INFO] BUILD SUCCESS 
INFO] -= 
INFO] Total time: 01:41 min 
INFO] Finished at: 2018-03-31T21:47:43+08:00 
INFO] Final Memory: 31M/306M 
[INFO] senna cin sce Rass 

(2) 把 程序 传 至 服务 器 

生产 环境 的 管理 一 般 是 运 维 人 员 进 行 的 ， 他 们 可 能 会 使 用 非常 严格 的 安全 认证 才能 连接 上 
生产 环境 ， 例 如 使 用 动态 密码 等 工具 。 这 些 对 于 研发 来 讲 可 能 就 太 专 业 了 ， 本 节 仅 需要 把 jar 传 
到 服务 器 的 某 个 位 置 即 可 。 使 用 VanDyke 公司 的 SecureFX 一 个 可 视 化 的 工具 )， 拖 动 文件 即 
可 实现 文件 上 传 ， 所 以 不 再 过 多 介绍 。 

(3) 局 动 服务 

前 面 已 经 介绍 了 Linux 的 基本 命令 ， 所 以 这 里 就 不 过 多 介绍 。 登 录 Linux 服务 器 进入 jar 包 
的 文件 夹 ， 通 过 如 下 命令 启动 服务 。 

$ nohup java -jar SpringBootBasic-0.0.1-SNAPSHOT.jar & 
(4) 服务 运行 情况 如 图 7-15 所 示 。 
可 见 ，Spring Boot 服务 可 以 在 Linux 服务 器 上 顺利 运行 。 


SS SS SS) 
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€ CŒ | © 47.93.199.101:18088/page/createuse 


创建 用 户 


图 7-15 Linux 服务 运行 


7.8 ”参数 校 验 

目前 的 Spring Boot 工程 已 经 实现 了 程序 的 接口 与 方法 的 映射 、 页 面 的 显示 、 业 务 罗 辑 的 处 
里 、 数 据 的 保存 ， 并 且 把 程序 已 经 运行 到 服务 器 了 ， 好 像 这 个 程序 的 所 有 事情 都 已 经 完成 了 。 
那么 请 看 下 面 的 情况 ， 如 图 7-16 所 示 。 


€ > GC |© localhost:18088/page/createuse 
创建 用 


ea 


名 字 : [spring cloud 
年 龄 fno 
电话 号 码 : no 
住址 : [spring 


创建 取消 


图 7-16 输入 错误 用 户 信息 
如 果 使 用 之 前 的 代码 ， 程序 会 报告 错误 。 如 图 7-17 所 示 。 


< G | © localhost:1 8/page 


Whitelabel Error pane 


This application has no explicit mapping for /error, so you are seeing this as a fallback. 


Mon Apr 02 15:56:06 CST 2018 
There was an unexpected error (type=Bad Request, status=400). 
Validation failed for object="user’. Error count: 


图 7-17 错误 信息 
彰 误 的 原因 是 通过 表单 构建 User 对 象 的 时 候 ， 由 于 年 龄 和 电话 号 码 使 用 了 错误 的 类 型 ， 所 
以 无 法 正确 赋值 给 User 对 象 。 因 此 需要 修改 代码 。 


7.8.1 ”前台 完成 基本 参数 校 验 
参数 的 校 验 一 般 是 需要 前 后 台 配 合 的 ， 前 台 期 望 得 到 正确 的 返回 ， 所 以 前 台 会 尽量 矫正 用 
户 的 输入 错误 ， 并 且 尽 量 保证 数据 的 正确 。 后 台 会 验证 数据 的 合法 性 来 保证 业务 的 正确 。 对 于 


类 刑 ， 


上 述 错误 情况 ， 前 全 可 以 进行 如 下 修改 ， 在 模板 页 面 限定 用 户 的 输入 类 型 


<p> 


<label style="font-size: 18px" th:text="' 年 龄 : "></label> <input 
type="number" id="age" name="age" tabindex="2"></input> 
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</p> 
<p> 
<label style="font-size: 18px" th:text="' 电 话 号 码 : "></label> <input 
type="number" id="phoneNum" name="phoneNum" tabindex="3"></input> 
</p> 
模板 中 限定 输入 年 龄 和 手机 号 的 输入 框 必须 输入 数字 ， 这 样 就 可 以 保证 前 台 输 入 类 型 的 了 
确 性 。 


7.8.2 ”前 后 台 配 合 完成 数据 校 验 


设想 一 种 情况 ， 如 果 用 户 输入 的 数据 不 合法 ， 例 如 年 龄 字段 输入 负数 或 者 大 于 200 的 数 
字 ， 这 样 的 数据 对 于 业务 来 讲 是 没有 意义 的 5。 那 么 可 以 通过 后 台 进 行 用 户 输入 的 校 验 ， 并 且 通 
过 前 台 显 示 提 示 信 息 ， 这 里 使 用 了 hibernate validator? 组 件 。 
要 想 实现 此 能 力 ， 需 要 修改 几 个 地 方 ， 首 先 ， 后 台 的 提交 接口 需要 具备 可 以 验证 的 能 力 ; 
其 次 ， 针 对 每 个 字段 的 验证 ， 需 要 设置 字段 规则 ; 最后， 前 台 可 以 接收 验证 的 结果 并 且 展示 4H 
来 。 优化 部 分 就 是 保留 用 户 已 填 内 容 ， 避 人 免 由 于 部 分 内 容 填写 错误 而 导致 所 有 信息 全 部 重 填 。 
(1) 后 台 接 口 修改 
修改 save 接口 ， 对 前 端 传 入 的 数据 进行 验证 ， 并 且 返 回 页面 和 错误 信息 。 修 改 createuser 
接口 ， 使 前 台 页 面 可 以 正确 显示 。 
@RequestMapping(value="/createuser") 
public ModelAndView createUser() { 
ModelAndView modelAndView = new ModelAndView("createuser"); 


modelAndView.addObject("user" new User()); 
return modelAndView; 


FH 


EE 


F | 


} 
@RequestMapping(value="/save") 
public ModelAndView save(@Valid User user,BindingResult result, Model model) { 
if(result!=null && result.hasErrors()) { 
ModelAndView modelAndView = new ModelAndView("createuser"); 
modelAndView.addObject(model); 
return modelAndView; 
yelse { 
userService.add(user); 
List<User> list = userService.getList(); 
ModelAndView modelAndView = new ModelAndView("save"); 
modelAndView.addObject("list", list); 
return modelAndView; 


} 
在 save 方法 中 ， 通 过 @Valid 注解 验证 对 象 数据 ， 通 过 BindingResult 实例 返回 页 面 错 误 信 
上 县， 并 且 根 据 数据 是 否 发 生 错 误 返 回 不 同 的 页 面 。 

(2) 数据 字段 验证 规则 

设置 每 个 字段 的 校 验 规 则 ， 输 入 的 字段 必须 符合 校 验 的 要 求 ， 否 则 不 能 ; 


2 


O 这 里 不 考虑 其 他 情况 ， 例 如 从 某 些 产品 来 讲 ， 希 望 获取 用 户 的 门槛 越 低 越 好 ， 尽 管用 户 输入 了 一 个 不 合理 数据 也 期 望 用 户 能 够 
使 用 业务 。 
© hibernate validator 不 需要 单独 引用 ，Web 起 步 依赖 已 经 集成 。 


173 


Java 服务 端 研 发 知识 图 谱 


@Entity 

@Table(name="User") 

public class User { 
@Id 
@GeneratedValue(strategy=GenerationType.IDENTITY) 
private int id; 
@NotBlank(message="Ut 4 HEA 28") 

private String name; 


@NotNull(message=" 


年 龄 不 和 


Eu") 


@Min(value=0,message=" 输 入 年 龄 小 


于 最 小 值 ") 


@Max(value=150,message" 输 入 和 


FE 龄 大 于 最 大 值 ') 


private Integer age; 


@Length(min=7,max=11,message = "输入 号 人 码 错误 ") 
private String phoneNum; 


@NotBlank(message=" 地 址 不 能 为 空 ") 
private String address; 


} 
代码 


修改 了 age 字段 的 类 型 ，! 


可 以 避免 前 台 页 面 默认 显示 int 的 


int 改 为 Integer, KF 


初始 化 数字 0, BA Integer 后 前 台 没 有 默认 输出 内 容 。 
User 类 中 针对 每 个 字段 都 做 了 限定 ， 例 如 设置 了 年 龄 的 最 大 /最 小 值 ， 输 入 手机 号 码 的 长 度 
限制 等 ， 其 实 validator 还 有 很 多 其 他 注解 可 以 限定 字段 校 验 ， 见 表 7-3。 
表 7-3 validator 注解 

$w f 作 
@Null 限制 只 能 为 null 
@NotNull 限制 不 能 为 null 
@AssertFalse 限制 必须 为 false 
@AssertTrue 限制 必须 为 tue 
@DecimalMax(value) 限制 必须 为 一 个 不 大 于 指定 值 的 数字 
@DecimalMin(value) 限制 必须 为 一 个 不 小 于 指定 值 的 数字 
@Digits(integer, fraction) 限制 必须 为 一 个 小 数 ， 且 整数 部 分 的 位 数 不 能 超过 integer， 小 数 部 分 的 位 数 不 能 超过 fraction 
@Future 限制 必须 是 一 个 将 来 的 日 期 
@Max(value) 限制 必须 为 一 个 不 大 于 指定 值 的 数字 
@Min(value) 限制 必须 为 一 个 不 小 于 指定 值 的 数字 
@Past 限制 必须 是 一 个 过 去 的 日 期 
@Pattern(value) 限制 必须 符合 指定 的 正则 表达 式 
@Size(max,min) 限制 字符 长 度 必须 在 min 到 max 之 间 
@Past 验证 注解 的 元 素 值 〈 日 期 类 型 ) 比 当 前 时 间 早 
@NotEmpty 验证 注解 的 元 素 值 不 为 null 且 不 为 空 〈 字 符 串 长 度 不 为 0、 集合 大 小 不 为 0) 
@NotBlank Ree SERENA E (不 为 null, 去 除 首位 空格 后 长 度 为 0)， 不 同 于 @NotEmpty，@NotBlank 

只 应 用 于 字符 串 且 在 比较 时 会 去 除 字符 串 的 空格 

@Email 验证 注解 的 元 素 值 是 Email， 也 可 以 通过 正则 表达 式 和 flag 指定 自 定义 的 Email 格式 
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(3) 修改 前 台 显 示 模 板 
前 台 显示 模板 的 修改 较为 简单 ， 主 要 是 两 点 ， 分 别 是 错误 信息 显示 和 已 填 信 息 的 回填 。 
createuserhtml 文件 具体 如 下 。 


<html xmlns:th="http://www.thymeleaf.org"> 
<head> 
<title>create user</title> 
<meta http~equiv="Content-Type" content="text/html; charset=UTF-8" /> 
</head> 
<body> 
<div> 
<label style="font-size: 18px" th:text="" 创 建 用 户 "></label> 
</div> 


<form th:action="@ {/page/save}" method="post" th:object="$ {user}" 
style="width: 600px"> 
<fieldset> 
<p> 
<label style="font-size: 18px" th:text=" 名 字 : "></label> <input 
type="text" id="$name" name="name" tabindex="1" th:field= "* {name} "> </input> 
<td th:if"$ {#fields.hasErrors(‘name')}" th:errors="* {name}" /> 
</p> 
<p> 


<label style="font-size: 18px" th:texf" 年 龄 : "></label> <input 
type="number" id="age" name="age" tabindex="2" th:field= "* {age}"> </input> 
<td th:if"$ {#fields.hasErrors(‘age')}" th:errors="* {age}" /> 


</p> 


<p> 
<label style="font-size: 18px" th:text="Hi S14: "></label> <input 
type="number" id="phoneNum" name="phoneNum" tabindex="3" 
th:field="* {phoneNum}"></input> 
<td th:if"$ {#fields.hasErrors(‘phoneNum')}" th:errors="* {phoneNum}" /> 
</p> 
<p> 


一 1 


<label style="font-size: 18px" th:text=" 住 址 : "></label> <input 
type="text" id="address" name="address" tabindex="4" 
th:field="* {address}"></input> 
<td th:if="$ {#fields.hasErrors(‘address')}" th:errors="* {address}" /> 
</p> 
<p id="buttons"> 
<input id="submit" type="submit" tabindex="5" value=" 4!"></input> <input 
id="reset" type="reset" tabindex="6" value=" 取 消 "></input> 
</p> 
</fieldset> 
</form> 


</body> 


</h 


tml> 


页 面 模板 在 input 标签 中 添加 也 :field="*fname}"， 来 做 已 填 数 据 的 回填 ， 通过 <td 
th:if="$ {#fields.hasErrors('name')}" th:errors="*{name}" 户 来 检测 错误 信息 ， 如 果 有 错误 则 显示 。 


(4) 效果 展示 


TT 


现在 打 了 


观察 页 面 的 变化 。 如 图 7-18 
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所 示 。 

现在 ， 这 个 Spring Boot 工程 既 可 以 执行 基本 的 业务 逻辑 ， 又 可 以 通过 前 台 的 限制 和 后 台 的 
校 验 保证 业务 的 准确 ， 并 且 人 性 化 地 提示 了 错误 的 原因 。 对 于 后 台 研 发 人 员 来 讲 ， 前 台 的 页 面 
部 分 了 解 这 些 已 经 可 以 了 。 


€ C © localhost:18088 


创建 用 / 
名 字 : 姓名 不 能 为 空 
年 龄 : 年 龄 不 能 为 空 
电话 号 码 : 输入 号 码 错误 
住址 : 地 址 不 能 为 空 
ae || 取消 


图 7-18 输入 错误 提示 


7.9 MyBatis 的 框架 整合 及 数据 校 验 


对 于 很 多 后 人 台 研 发 人 员 来 讲 ， 可 能 不 太 习 惯 IPA 的 使 用 方式 ， 大 家 可 能 更 习惯 使 用 
MyBatis 操作 数据 库 。 下 面 就 介绍 MyBatis 的 Spring Boot 工程 集成 方法 ， 并 且 通 过 validator 对 
纯 后 台 接 口 进 行 数据 校 验 和 错误 返回 。 


7.9.1 整合 MyBatis 
在 讲解 Spring 的 时 候 ， 已 经 添加 了 MyBatis 的 整合 ， 所 以 本 节 简 单 介 


MyBatis 整合 。 新 建 一 个 工程 SpringBootMybatis。 
C1) 添加 依赖 
于 Spring Boot 的 起 步 依赖 较为 完善 ， 所 以 此 工程 添加 的 依赖 主要 是 以 下 3 个 。 


<dependency> 
<groupld>org.springframework.boot</groupId> 
<artifactId>spring—boot-starter-web</artifactld> 

</dependency> 

<dependency> 
<groupId>org.mybatis.spring.boot</groupId> 
<artifactlId>mybatis-spring—boot-starter</artifactld> 
<version>1.3.2</version> 

</dependency> 

<dependency> 
<groupId>mysql</groupId> 
<artifactlId>mysql-connector—java</artifactld> 
<scope>runtime</scope> 

</dependency> 


(2) 配置 yml 文件 
在 配置 文件 中 ， 配 置 数据 库 连 接 datasource 和 Mybatis 的 相关 路 径 。 


server: 
port: 18089 


\NS 


召 Spring Boot 的 
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spring: 
application: 
name: SpringBootMybatis 
datasource: 
driver-class-name: com.mysql.jdbc.Driver 
url: jdbc:mysql://39.106.10.196:3306/javadevmap?characterEncoding=utf-8 
username: root 
password: mypass 
mybatis: 
type-aliases-package: com.javadevmap.mybatis.*.model 
mapper-locations: classpath:/mybatis/sqlmap/*.xml 
config—location: classpath:/mybatis/mybatis-config.xml 


(3) 添加 Mybatis 配置 文件 
在 mybatis-config.xml 文件 中 添加 如 下 配置 。 


<?xml version="1.0" encoding="UTF-8"?> 
<!DOCTYPE configuration 
PUBLIC "-//www.mybatis.org//DTD Config 3.0//EN" 
"http://mybatis.org/dtd/mybatis—3-config.dtd"> 
<configuration> 
<settings> 
<setting name="cacheEnabled" value="true" /> 
<setting name="lazyLoadingEnabled" value="true" /> 
<setting name="multipleResultSetsEnabled" value="true" /> 
<setting name="useColumnLabel" value="true" /> 
<setting name="useGeneratedKeys" value="false" /> 
<setting name="defaultExecutorType" value="SIMPLE" /> 
<setting name="defaultStatementTimeout" value="25000" /> 
</settings> 
</configuration> 


(4) 配置 生成 文 们 
在 generatorConfig.xml 文件 中 添加 如 下 配置 ， 这 里 设置 直接 将 生成 的 代码 添加 至 工程 中 。 
<?xml version="1.0" encoding="UTF-8"?> 
<!DOCTYPE generatorConfiguration 


PUBLIC "~//mybatis.org//DTD MyBatis Generator Configuration 1.0//EN" 
"http://mybatis.org/dtd/mybatis-generator-config 1 0.dtd"> 


TT 


O 


<generatorConfiguration> 
<classPathEntry location="C:\Users\T460\.m2\repository\mysq|\ 
mysql-connector-java\5.1.44\mysql-connector—java-5.1.44.jar" /> 
<context id="mysqlStepyee" targetRuntime="MyBatis3" > 
<commentGenerator> 
<property name="suppressAll1Comments" value="true" /> 
<property name="suppressDate" value="true" /> 
</commentGenerator> 
<jdbcConnection driverClass="com.mysql.jdbc.Driver" 
connectionURL="jdbe:mysql://39.106.10.196:3306/javadevmap? 
autoReconnect=true&amp;useUnicode=true&amp;characterEncoding=utf8" 
userld="root" password="mypass"> 
</jdbcConnection> 
<javaTypeResolver> 
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<property name="forceBigDecimals" value="false"/> 
</javaTypeResolver> 
<javaModelGenerator targetPackage="com.javadevmap.mybatis.model" 
targetProject="src\main\java"> 
<property name="enableSubPackages" value="true"/> 
<property name="trimStrings" value="true"/> 
</javaModelGenerator> 
<sqlMapGenerator targetPackage="mybatis.sqimap" targetProject="src\main\resources"> 
<property name="enableSubPackages" value="true"/> 
</sqlMapGenerator> 
<javaClientGenerator type="MIXEDMAPPER" 
targetPackage="com.javadevmap.mybatis.model.mapper" 
targetProject="src\main\java"> 
<property name="enableSubPackages" value="true"/> 
</javaClientGenerator> 
<table tableName="user" schema="javadevmap"/> 
</context> 
</generatorConfiguration> 


(5) 添加 插件 并 生成 
在 pom 文件 中 ， 添 加 如 下 生成 插件 ， 然 后 运行 生成 命令 “Run As->Maven build...”， 输入 
框 中 填写 mybatis-generator:generate， 点 击 Run 即 可 生成 代码 。 


<build> 
<plugins> 


<plugin> 
<groupId>org.mybatis.generator</groupId> 
<artifactId>mybatis-generator-maven-plugin</artifactId> 
<version>1.3.2</version> 
<configuration> 
<configurationFile>src/main/resources/mybatis/generatorConfig.xml 
</configurationFile> 
<overwrite>true</overwrite> 
</configuration> 
</plugin> 
</plugins> 
</build> 
(6) 启动 类 配置 
在 启动 类 中 添加 @MapperScan("com.javadevmap.mybatis.model.mapper") 注 解 ， 用 于 扫描 
mapper 文件 。 
(7) 添加 DAO 
添加 DAO 类 的 接口 和 实现 ， 用 于 操作 数据 库 ， 类 中 添加 两 个 方法 ， 一 个 是 查询 ， 一 个 
是 保存 。 
public interface UserDao { 
public User getUser(int id); 
public int saveUser(User user); 


} 
@Repository 
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public class UserDaoImpl implements UserDao { 
@Autowired 
private UserMapper mapper; 


@Override 
public User getUser(int id) { 
return mapper.selectByPrimaryKey(id); 


} 


@Override 
public int saveUser(User user) { 
return mapper.insert(user); 
j 
} 


(8) 添加 一 个 承接 请 求 的 User 类 
虽然 MyBatis 自动 生成 时 ， 会 生成 一 个 User 类 ， 但 是 为 了 不 破坏 自动 生成 的 代码 ， 或 者 避 
免 修改 User 文件 后 又 被 自动 生成 所 有 覆盖， 所 以 这 里 定义 一 个 用 于 承接 Web 请 求 的 DomainUser 


public class DomainUser { 
private Integer id; 
private String address; 
private Integer age; 
private String name; 
private String phoneNum; 
//...getset 


} 
(9) 添加 Service 
添加 Service 类 的 接口 和 实现 ， 用 于 业务 逻辑 的 处 理 ， 在 Service 中 注入 Dao 类 用 以 操作 数 


public interface UserService { 
public DomainUser getUser(int id); 
public int saveUser(DomainUser user); 


j 


@Service 

public class UserServiceImpl implements UserService{ 
@Autowired 
private UserDao dao; 


@Override 
public DomainUser getUser(int id) { 
User user = dao.getUser(id); 
if(user!=null) { 
DomainUser domainUser = new DomainUser(); 
BeanUtils.copyProperties(user, domainUser); 
return domainUser; 


} 


return null; 
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@Override 

public int saveUser(DomainUser domainUser) { 
User user = new User(); 
BeanUtils.copyProperties(domainUser, user); 
return dao.saveUser(user); 


} 
(10) 添加 Controller 接口 


在 Controller 中 ， 注 入 Service 实现 ， 并 且 通 过 Service 进行 相应 的 业务 操作 。 接 口 使 用 
REST 的 方式 获取 用 户 信息 ， 通 过 post 请 求 添加 用 户 。 
@RestController 
@RequestMapping("/user") 
public class UserController { 

@Autowired 

private UserService service; 


@RequestMapping(value="/{Id}",method=RequestMethod.GET) 
public DomainUser getUser(@Path Variable("Id") int id) { 
return service.getUser(id); 


} 


@RequestMapping(value="/add",method=RequestMethod.POST) 
public void addUser(@RequestBody DomainUser user) { 
service.saveUser(user); 
} 
} 


C11) 获取 用 户 信息 
使 用 Postman， 可 以 轻松 地 通过 REST 接口 得 到 用 户 的 信息 。 如 图 7-19 所 示 。 


OK e: 1417 ms ze: 204 B 


Jl 


图 7-19 ”请求 用 户 信息 
(12) 添加 用 户 
可 以 使 用 Postman 工具 提交 一 个 POST 请 求 到 服务 器 ， 模 拟 真实 的 前 台 请 求 操 作 。 
Postman 的 参数 设置 如 图 7-20 所 示 。 
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图 7-20 Postman 参数 设置 
如 果 正 确 添加 用 户 数 据 ， 逻 辑 肯 定 会 正常 执行 ， 如 果 非 法 添加 用 户 数据 ， 并 且 希 望 后 台 服 
务 能 够 正确 检查 出 非法 的 原因 ， 那 么 就 义 涉及 了 参数 校 验 。 
7.9.2 后 侣 接口 请 求 校 验 
对 于 前 台 传 过 来 的 数据 ， 可 以 在 Controller 的 方法 中 用 站 语句 ， 逐 字段 判断 其 是 否 符合 业务 
规则， 然后 向 前 台 反 馈 错误 信息 ， 例 如 


if(user.getAddress()==null) { 
return "address can not be null!"; 


} 

这 种 方法 完全 可 行 ， 而 且 已 经 成 为 很 多 编程 人 员 的 习惯 用 法 ， 此 处 不 再 袭 述 。 至 于 这 个 返 
回 数 据 仅仅 是 个 String 类 型 ， 不 够 规范 的 问题 ， 会 在 下 一 小 节 中 介绍 返回 数据 规范 化 。 

此 工程 继续 使 用 validator 请 求 数据 校 验 。 校 验 的 是 接口 数据 而 非 前 台 页 面 传递 过 来 的 数 
据 ， 所 以 写法 上 存在 一 些 差 异 ， 但 是 原理 基本 相同 。 

(1) DomainUser 添加 注解 规范 

和 验证 前 端 数据 一 样 ， 从 REST 接口 获得 的 数据 如 果 要 进行 合法 性 校 验 ， 也 要 添加 validator 
注解 。 


public class DomainUser { 
private Integer id; 


@NotBlank(message=" 地 址 不 能 为 空 ") 
private String address; 


G@NotNulltmessage=" 年 龄 不 能 为 空 " 
@Min(value=0,message=" 输 入 年 龄 小 于 最 小 值 ) 
@Max(value=150,message=" 输 入 年 龄 大 于 最 大 值 ") 


private Integer age; 


@NotBlank(message=" 姓 名 不 能 为 空 ) 
private String name; 


@Length(min=7,max=11,message = "输入 号 码 错误 ") 
private String phoneNum; 
} 
(2) Controller 类 修改 方法 参数 
在 Controller 类 的 addUser 方法 中 添加 @Vvalid 注解 ， 用 以 标明 需要 验证 的 参数 。 
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@RequestMapping(value="/add",method=RequestMethod.POST) 
Public void addUser(@RequestBody @ Valid DomainUser user) { 


service.saveUser(user); 


} 


(3) 验证 校 验 情况 
通过 Postman 提交 请 求 ， 故 意 把 address 字段 的 数据 删 掉 ， 观 察 返回 结果 。 
{ 
"timestamp": 1522825947907, 
"status": 400, 
"error": "Bad Request", 
PCR "org.springframework.web.bind.MethodArgumentNotValidException", 
"errors": [{ 
"codes": ["NotBlank.domainUser.address", "NotBlank.address", "NotBlank.java.lang.String", 
"NotBlank"], 


"arguments": [{ 
"codes": ["domainUser.address", "address"], 


"arguments": null, 
"defaultMessage": "address", 
"code": "address" 


省 
"defaultMessage": "地 址 不 能 为 空 ",， 


"objectName": "domainUser", 
"field": "address", 

"rejected Value": "" 
"bindingFailure": fe 
"code": "NotBlank" 


y 


"message": "Validation failed for object='domainUser'. Error count: 1", 
"path": "/user/add" 
} 
validator 校 验 了 请 求 参数 ， 并 且 返 回 了 大 量 的 用 于 排查 问题 的 信息 ， 其 中 包含 了 代码 中 的 
自 定义 错误 提示 语 “ 地 址 不 能 为 空 ”。 虽然 validator 返回 的 数据 非常 完善 ， 但 是 对 于 前 端 研发 人 
员 来 讲 ， 他 们 a i 回 的 数据 有 具备 统一 模板 ， 而 不 是 突然 出 现 的 validator 风格 的 错误 提 


示 ， 所 以 工程 面临 统一 返回 模板 的 问题 。 


7.9.3 规范 数据 返回 

下 面 规范 一 个 最 简单 的 返回 模板 ， 包 含 返 回信 息 人 码 、 
Bo M Java 泛 型 模板 来 实现 返回 格式 的 统一 

(1) 定义 数据 统一 返回 模板 
先 定义 一 个 枚 举 值 ， 通 过 枚 举 值 生成 统一 返回 模板 的 错误 码 和 返回 信息 。 


J » A 


W 


k 


返回 信息 提示 语 和 前 台 需 要 的 数据 对 


a 


public enum ResultCode { 
OK,Bad_Request,Unauthorized,Not_Found,ERROR,Unavailable 


} 


public class Result<T> { 
private int resultCode; 
private String msg; 
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private T data; 
public Result() { 


} 


public Result(int code,String msg) { 
this.resultCode = code; 
this.msg = msg; 


} 


public Result(int code,String msg,T data) { 
this.resultCode = code; 
this.msg = msg; 
this.data = data; 


} 


public Result(ResultCode rCode) { 
switch (rCode) { 


case OK: 
this.resultCode = 200; 
this.msg = "ok"; 
break; 


case Bad_Request: 
this.resultCode = 400; 
this.msg = "Bad Request"; 
break; 

case Unauthorized: 
this.resultCode = 401; 
this.msg = "Unauthorized"; 
break; 

case Not_Found: 
this.resultCode = 404; 
this.msg = "Not Found"; 
break; 

case ERROR: 
this.resultCode = 500; 
this.msg = "Server Error"; 
break; 

case Unavailable: 
this.resultCode = 503; 
this.msg = "Service Unavailable"; 
break; 

default: 
this.resultCode = 400; 
this.msg = "Bad Request"; 
break; 


} 


public Result(ResultCode rCode,T data) { 
this(rCode); 
this.data = data; 


Spring Boot 
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} 


public int getResultCode() { 
return resultCode; 

} 

public void setResultCode(int resultCode) { 
this.resultCode = resultCode; 


} 

public String getMsg() { 
return msg; 

j 


public void setMsg(String msg) { 
this.msg = msg; 

} 

public T getData() { 
return data; 

} 

public void setData(T data) { 
this.data = data; 

} 

} 


(2) 修改 Controller 接口 
对 Controller 中 对 外 提供 接口 的 方法 进行 修改 ， 使 其 返回 的 数据 格式 统一 为 Result。 


@RestController 
@RequestMapping("/user") 
public class UserController { 
@Autowired 
private UserService service; 


@RequestMapping(value="/{Id}",method=RequestMethod.GET) 
public Result<DomainUser> getUser(@PathVariable("Id") int id) { 
DomainUser user = service.getUser(id); 
Result<DomainUser> result = null; 
if(user!=null) { 
result = new Result< >(ResultCode.OK, user); 
yelse { 
result = new Result<>(ResultCode.Not_Found); 
} 


return result; 


} 


@RequestMapping(value="/add",method=RequestMethod.POST) 
public Result<String> addUser(@RequestBody @Valid DomainUser user) { 
int ret = service.saveUser(user); 
Result<String> result = null; 
if(ret == 1) { 
result = new Result<>(ResultCode.OK); 
yelse { 
result = new Result<>(ResultCode.ERROR); 
} 


return result; 
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} 


(3) 返回 信息 展示 
请 求 getUser 对 外 提供 的 接口 ， 观 察 其 数据 返回 情况 。 


成 功 情况 : 
"resultCode": 200, 
"msg": "ok", 
"data": { 
"id": 8, 
"address": "HWER", 
"age": 18, 


mon 


"name": "maven", 
"phoneNum": "12345678901" 


} 

} 

失败 情况 : 

{ 
"resultCode": 404, 
"msg": "not found", 
"data": null 

} 


可 见 ， 数 据 返回 已 经 具备 了 标准 统一 的 格式 ， 但 是 对 于 通过 validator 校 验 失败 的 请 求 ， 其 
返回 格式 还 没有 被 统一 进来 ， 所 以 需要 进行 如 下 修改 。 
(4) 模板 化 validator 输出 
对 validator 的 标准 化 ， 需 要 对 validator 抛 出 的 异常 进行 统一 处 理 ， 然 后 返回 模板 化 错误 信 
Ah, HARU F. 
@ControllerAdvice 
public class ParamValidateControllerAdvice { 
@ExceptionHandler( {MethodArgumentNotValidException.class}) 
@ResponseBody 
public Result<String> handleMethodArgumentNotValidException(MethodArgumentNotValidException e) { 
return handleFieldErrors(e.getBindingResult()); 


五 


j 


public Result<String> handleFieldErrors(BindingResult bindingResult) { 
List<FieldError> fieldErrors = bindingResult.getFieldErrors(); 
List<String> errors = new ArrayList(); 
for(FieldError error : fieldErrors) { 
errors.add(""+error.getField()+":"+error.getDefaultMessage()); 
} 
Result<String> result = new Result>(); 
result.setResultCode(400); 
result.setMsg(errors.toString()); 
return result; 
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这 样 ， 当 请 求 参数 发 生 错误 的 时 候 也 可 以 具有 统一 的 返回 信息 格式 了 。 例 如 当 提 交 的 所 有 
字段 都 不 合法 时 ， 会 出 现 如 下 提示 信息 。 


{ 
"resultCode": 400, 
msg": "[phoneNum: 输 入 号 码 错 误 , name: 姓 名 不 能 为 空 , address: 地 址 不 能 为 空 ,age: 输 入 年 龄 大 于 
最 大 值 ]", 
"data": null 
} 


7.10 添加 日 志 及 记录 请 求 信息 1S 


对 于 这 个 工程 ， 可 能 还 需要 记录 一 些 日 志 信息 ， 这 些 日 志 信息 在 服务 运行 时 会 辅助 研发 人 
员 调 试 程 序 。 可 以 使 用 AOP 技术 进行 切面 逻辑 的 添加 ， 在 Controller 中 记录 服务 器 收 到 请 求 和 
返回 的 数据 ， 这 样 如 果 服 务 出 现 问题 可 以 方便 排查 。 


7.10.1 添加 日 志 模 上 块 


日 志 模 块 在 第 5 章 介绍 过 ， 这 里 只 是 简单 介绍 Spring Boot 工程 的 日 志 引 入 方法 。 
(1) 使 用 yml 文件 配置 志 
由 于 日 志 组 件 的 依赖 已 经 通过 Spring Boot 的 起 步 依赖 引入 进来 ， 所 以 这 里 不 再 单独 引入 日 
志 的 pom 文件 依赖 。 之 前 工程 一 直 没 有 特意 去 配置 日 志 ， 但 是 控制 台 却 都 有 日 志 的 打印 ， 这 是 
Spring Boot 工程 的 自动 配置 做 的 事情 。 所 以 对 于 日 志 来 讲 ， 在 还 没有 关注 它 的 时 候 它 就 已 经 可 
以 正确 输出 了 。 
如 果 只 是 简单 地 使 
logging: 
level: 
root: DEBUG 
pattern: 
console: "Yod — %msg%n" 
path: /logs 
上 面 的 配置 ， 设 置 了 日 志 的 总 体 打印 级 别 是 DEBUG， 设 置 了 日 志 的 打印 格式 ， 还 设置 了 一 
个 日 志文 件 的 输出 路 径 。 如 果 启 动工 程 ， 就 可 以 在 控制 台 和 对 应 路 径 下 看 到 日 志 。 
如 果 要 在 程序 内 手动 打印 日 志 ， 只 要 在 类 中 创建 日 志 引 用 ， 在 方法 中 使 用 log.info 日 志 打 
印 ， 即 可 打印 日 志 。 
import org.slf4j.Logger; 
import org.slf4j.LoggerFactory; 


了 志 ， 对 配置 文件 进行 简单 修改 即 可 。 


a 


@RestController 
@RequestMapping("/user") 
public class UserController { 
private static final Logger log = LoggerFactory.getLogger(UserController.class); 


@RequestMapping(value="/{Id}",method=RequestMethod.GET) 


public Result<DomainUser> getUser(@PathVariable("Id") int id) { 
DomainUser user = service.getUser(id); 
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Result<DomainUser> result = null; 
if(user!=null) { 

result = new Result<DomainUser>(ResultCode.OK, user); 
yelse { 

result = new Result<DomainUser>(ResultCode.Not_Found); 


} 
log.info(result.toString()); 
return result; 


j 
(2) TE resources 文件 夹 下 添加 日 志 配 置 文件 
使 用 上 面 的 方法 虽然 可 以 正确 打印 日 志 ， 但 是 配置 项 还 是 相对 较 少 ， 所 以 可 以 使 用 常规 的 
志 配置 方法 打印 日 志 。 注 释 掉 yml 文件 的 日 志 配置 ， 在 resources 文件 夹 下 创建 logback- 
spring.xml 文件 。 


<?xml version="1.0" encoding="UTF-8"?> 

<configuration debug="true"> 
<include resource="org/springframework/boot/logging/logback/defaults.xml" /> 
<property name=""APP_ Name" value="SpringBootMybatis" /> 
<property name="LOG HOME" value="/logs" /> 
<contextName>${APP_Name}</contextName> 


<jmxConfigurator /> 
<appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender"> 
<encoder> 
<pattern>%od {yyyy-MM-dd} %d{HH:mmiss.SSSZ} %-Slevel Yologger {36}[$ {APP Name} ], [%15.15t] : 
%m%n%wEx</pattern> 
</encoder> 
</appender> 


<appender name="FILE" 

="ch.qos.logback.core.rolling.RollingFileAppender"> 

<rollingPolicy 
class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy"> 
<FileNamePattern>$ {LOG _HOME}/${APP_Name}/%d{yyyy-MM~—dd}.%i.log 
</FileNamePattern> 
<MaxHistory>10</MaxHistory> 
<maxFileSize>100MB</maxFileSize> 

</rollingPolicy> 


class: 


<layout class="ch.qos.logback.classic.PatternLayout"> <pattern>%d {yyyy-MM— 
dd} %d{HH:mmiss.SSSZ} %-Slevel Ylogger {36}[${APP_Name}], [%15.15t] : Ym%n%wEx</pattern> 
</layout> 
</appender> 


<root level="info"> 
<appender-tef ref="STDOUT" /> 
<appender-tef ref="FILE" /> 
</root> 
</configuration> 


添加 以 上 配置 后 ， 日 志 可 以 通过 控制 台 和 文件 分 别 输出 。 日 志文 件 的 条 


TT 
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F 


大 小 两 个 维度 限制 ， 即 日 志 记录 超过 一 天 或 者 日 志文 件 大 于 100MB 时 ， 则 拆 分 日 志文 件 。 


7.10.2 AOP 实现 接口 信息 打印 


上 一 节 在 方法 内 打印 了 请 求 的 返回 值 ， 如 果 有 多 个 请 求 的 话 则 需要 对 每 个 方法 逐一 添加 日 志 
打印 语句 ， 这 明显 是 重复 工作 ， 而 且 在 批量 添加 时 还 有 可 能 出 错 。 最 简单 的 办 法 就 是 使 用 AOP 技 
术 ， 使 用 AOP 技术 切入 方法 的 开始 和 结束 ， 打 印 方法 的 请 求 和 返回 值 。 

C1) 添加 AOP 依赖 


<dependency> 
<groupld>org.springframework.boot</groupId> 
<artifactld>spring—boot-starter-aop</artifactld> 
</dependency> 


(2) 添加 切面 类 


@Component 

@Aspect 

public class AopAspect { 
private static final Logger log = LoggerFactory.getLogger(AopAspect.class); 
ObjectMapper mapper = new ObjectMapper(); 


@Pointcut("execution(* com.javadevmap.mybatis.controllers..*.*(..))") 
public void AopPointCut() { 


} 


@Before(value="AopPointCut()") 
public void AopBefore(JoinPoint point) { 
try { 
StringBuilder builder = new StringBuilder(); 
builder.append(point.getSignature().getDeclaringTypeName()); 
builder.append(" method = "); 
builder.append(point.getSignature().getName()); 
builder.append(" args ="); 
for(Object object : point.getArgs()) { 
builder.append(mapper.write ValueAsString(object)); 
} 
log.info(builder.toString()); 
} catch (Exception e) { 
e.printStackTrace(); 
} 
} 


@AfterReturning(value="A opPointCut()" ,returning="ret") 
public void AopAfterReturning(JJoinPoint point,Object ret) { 
try { 

StringBuilder builder = new StringBuilder(); 
builder.append(point. ae eu getDeclaringTypeName()); 
builder.append(" method = " 
builder.append(point. getSignaure) getName()); 
builder.append(" args =" 
for(Object object : point Serres) { 
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builder.append(mapper.write ValueAsString(object)); 
} 
builder.append(" ret = "); 
builder.append(mapper.write ValueA sString(ret)); 
log.info(builder.toString()); 
} catch (Exception e) { 
e.printStackTrace(); 


j 
j 


第 7 章 Spring Boot 


如 上 代码 使 用 切面 切入 了 Controllers 包 中 的 所 有 类 ， 对 类 中 方法 的 开始 和 结束 插入 日 志 打印 


逻辑 ， 如 果 是 方法 的 开始 则 打印 方法 名 和 请 求 参 数 ， 如 果 是 方法 的 结 


束 则 再 添加 打印 返回 


T. Ñ 


过 这 么 一 个 简单 的 切面 类 ， 就 可 以 在 不 修改 接口 


(3) 日 志 结 果 


的 情况 下 ， 完 成 所 有 


WA 


请 求 和 返回 的 记录 。 


win 


使 用 浏览 器 访问 http://localhost:18089/user/10 这 个 get 接口 
2018-04-08 22:39:19.758+0800 INFO 


? 可 以 看 到 如 下 


c.j.mybatis.config.AopAspect[SpringBootMybatis], [io-18089- 


志 输 出 。 


exec-3] : com.javadevmap.mybatis.controllers.UserController method = getUser args = 10 


2018-04-08 22:39:19.777+0800 INFO 


c.j.mybatis.config.AopAspect[SpringBootMybatis], [i0-18089- 


exec-3| : com.javadevmap.mybatis.controllers. UserController method = getUser args = 10 ret = {"resultCode": 200, "msg": 
"ok","data": {"id":10,"address":"}h2k","age":18,"name":"spring MVC","phoneNum": "12345678901"? } 


a, 


4 


到 此 ， 本 章 对 Spring Boot 的 使 用 和 特性 已 经 介 乡 
程 目录 ， 如 图 7-21 AIAN, 已 经 初 规模 Jo 


v WS SpringBootMybatis [boot] JavaDeveloperMap master] 
v 大 src/main/java 


了 


如 comjavadevmap.mybatis 
FR comJjavadevmap.mybatis.config 
I comjavadevmap.mybatis.controllers 
H comjavadevmap.mybatis.dao 
网 comjavadevmap.mybatis.dao.impl 
网 comjavadevmap.mybatis.domain 
#8 com.javadevmap.mybatis.model 
#8 com.javadevmap.mybatis.model.mapper 
{RB comjavadevmap.mybatis.result 
£8 com,javadevmap.mybatis.service 
I com.javadevmap.mybatis.service.impl 
v A src/main/resources 
v 人 mybatis 
& sqlmap 
为 generatorConfig.xml 
为 mybatis-config.xml 
& static 
© templates 
% application.yml 
为 logback-spring.xml 


@ src/test/java 


民 多 。 现 在 看 看 SpringBootMybatis 的 工 


| 


图 7-21 项 目 工程 目录 
本 章 讲解 Spring Boot 的 自动 配置 和 起 步 依 赖 ， 以 这 两 点 为 基础 


TE 


通过 Thymeleaf 构建 了 前 


台 页 面 ， 通过 IPA 保存 数据 ， 通 过 端点 查看 程序 运行 情况 ， 集 成 Mybatis 用 于 提供 第 二 种 数据 


操作 方法 ; 使 用 validator 对 参数 进行 校 验 ， 统 一 
情况 。 了 解 了 这 些 ， 就 可 以 使 用 Spring Boot 


始 业务 的 研发 了 。 


返回 数据 的 格式 并 且 通 过 日 志 记 录 请 求 的 具体 
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8m 服务 架构 


第 一 篇 的 儿 间 内容， 从 Java 语言 开始 ， 讲 解 如 何 使 用 语言 以 及 了 解 语言 的 特性 ， 然 后 讲解 
了 Maven 工程 的 管理 ， 接 下 来 使 用 Git 和 Svn 版 本 控制 软件 来 管理 代码 ;介绍 了 Linux 系统 命 
S, FHE Linux 服务 器 中 运行 了 一 个 Java 程序 。 在 第 二 篇 的 头 几 章 内 容 中 ， 学 习 了 使 用 
Spring 框架 治理 来 管理 程序 ， 并 且 了 解 了 Spring MVC 的 页 面 编写 等 内 容 ， 上 一 章 使 用 Spring 
Boot 更 简便 地 管理 程序 。 其 实 到 目前 为 止 ， 已 经 可 以 通过 讲解 的 内 容 编写 自己 的 业务 了 。 但 是 
本 书 的 范围 明显 不 限于 此 。 通 过 本 章 的 了 解 ， 可 以 看 到 一 个 小 系统 是 如 何 一 步 步 变 大 的 ， 以 及 
系统 变 大 后 这 种 复杂 系统 的 管理 办 法 。 

以 一 个 电 商 系统 为 例 ， 电 商 系统 必须 包含 的 模块 有 : 用户、 商品、 订单 订购 关系 、 卖 家 及 后 
台 。 这 是 最 核心 的 几 个 模块 ， 是 初始 搭建 系统 的 时 候 ， 必 须 首 先 实现 的 。 如 果 用 Spring Boot 实现 
这 个 基础 系统 ， 那 么 这 些 模块 可 能 分 属 同一 个 工程 的 不 同 package， 但 是 总 体 还 是 一 个 程序 ， 程 序 
外 部 连接 数据 库 和 一 些 静态 的 图 片 资源 。 这 个 系统 可 能 会 部 署 在 一 台 服 务 器 之 内 ， 当 然 了 ， 如 果 
这 人 台 服 务 器 宕 机 了 ， 那 么 电 商 平台 也 完 重 了 。 这 个 初始 版 的 电 商 虽然 不 能 保证 稳定 地 提供 业务 ， 
但 是 它 确 实 具 备 了 基础 的 功能 业务 能 力 ， 如 图 8-1 所 示 。 

这 个 系统 的 所 有 组 件 都 部 署 在 同一 台 服 务 器 中 ， 数 据 库 和 程序 会 共用 CPU 和 内 存 ， 数 据 库 
和 文件 服务 会 共用 磁盘 ， 文 件 服务 会 和 程序 共用 网 络 带宽 。 随 着 这 个 小 电 商 系统 慢 慢 开 始 有 人 
访问 ， 如 果 服 务 器 性 能 不 高 的 话 ， 很 容易 形成 性 能 瓶颈， 此 瓶颈 是 由 硬件 资源 不 足 造成 的 。 在 
此 情况 下 ， 就 需要 根据 硬件 资源 的 具体 情况 ， 选 择 把 一 部 分 能 力 拆 分 出 去 ， 部 署 到 另外 一 台 服 
务 嚣 中， 例如 把 数据 库 系 统 和 静态 资源 拆 分 到 其 他 服务 器 ， 那 么 现在 就 具备 了 3 台 服 务 器 。 如 
8-2 所 示 。 


pa 


` 

0 应 用 服务 

Ss » 
应 用 服务 、 数 据 库 、 文 件 系统 文件 服务 
图 8-1 单机 服务 器 图 8-2 多 台 服 务 器 


有 一 天 ， 共 人 台 服 务 费 宕 机 了 ， 导 致 整个 系统 都 瘫痪 了 ， 研 发 人 员 突 然 认识 到 单 节 点 对 业务 
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造成 了 多 大 的 风险 。 现 在 业务 已 经 顺利 开展 了 ， 不 希望 这 种 事情 再 次 发 生 ， 于 是 决定 把 所 有 单 
节点 的 组 件 都 变 为 双 节 点 ， 这 样 即 使 其 中 一 台 瘫 病 ， 系 统 还 是 能 正常 运行 。 这 就 涉及 了 反 向 代 
理 和 负载 均衡 ， 需 要 把 系统 压力 合理 分 散 到 业务 承载 服务 器 上 ， 如 网 8-3 所 示 。 

数据 库 


反 向 代理 及 负载 应 用 服务 


文件 服务 


图 8-3 ”和 带 见 余 的 服务 器 集群 
业务 的 发 展 越 来 越 好 ， 用 户 越 来 越 多 ， 服 务 的 压力 也 越 来 越 大 ， 请 求 响应 时 间 开 始 变 长 。 

经 过 诊断 ， 发 现 几 种 情况 ， 例 如 程序 所 在 的 应 用 服务 器 CPU 使 用 率 非常 高 ， 那 么 应 该 扩容 应 用 

服务 器 ， 提 供 更 多 的 程序 节点 ;例如 发 现 数据 库 查 询 越 来 越 慢 ， 可 能 会 对 数据 库 进 行 分 表 或 者 

读 写 分 离 ， 进 行 多 写 多 读 ， 或 者 使 用 分 布 式 缓存 5 和 本 地 缓存 ， 以 降低 数据 库 的 压力 ， 例 如 静态 

资源 获取 非常 慢 ， 可 能 会 对 静态 资源 配置 CDN 以 提高 速度 ， 如 图 8-4 所 示 。 

缓存 


数据 库 


NE 
反 向 代理 及 负载 | | 应 用 服务 € 3 
‘J 文件 服务 CDN 


gg 


图 8-4 ”加 入 数据 缓存 等 服务 器 集群 


E 


O 缓存 的 读 写 能 力 强 于 数据 库 ， 可 以 把 一 些 经 常 访 问 的 数据 放 入 缓存 中 ， 以 降低 数据 库 的 压力 。 本 地 缓存 也 是 提高 性 能 的 好 办 
法 ， 只 是 同步 问题 需要 解决 。 
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业务 已 经 运行 了 很 长 时 间 了 ， 工 程 中 代码 实现 的 业务 逻辑 也 越 来 越 多 ， 越 来 越 复 杂 。 例 
如 订单 模块 里 会 有 打折 ， 打 折 还 要 根据 用 户 的 等 级 设置 折扣 比例 ， 用 户 等 级 的 提高 需要 达到 
某 个 条 件 才 行 ， 这 个 条 件 的 统计 可 能 还 在 订单 模块 里 ， 这 些 相 关联 的 模块 对 研发 和 测试 工作 
造成 了 很 大 的 复杂 度 ， 可 能 修改 一 个 小 地 方 需要 全 系统 的 测试 才能 完成 。 为 了 降低 程序 内 模 
块 间 的 复杂 度 ， 可 不 可 以 把 这 些 模块 拆 分 为 单独 的 服务 ?每 个 服务 负责 一 部 分 能 力 ， 通 过 接 
口 对 外 提供 能 力 文 持 ， 各 个 服务 之 间 也 通过 接口 进行 通信 。 当 某 个 服务 更 新 了 ， 只 要 测试 这 
个 服务 的 接口 能 力 就 可 以 了 ， 这 样 降低 了 全 量 集 成 测试 的 工作 量 ， 所 以 微服 务 的 理念 就 诞生 
了 。 微 服务 是 把 一 个 大 的 程序 拆 分 成 一 堆 具 备 独 立 能 力 的 程序 集合 ， 这 种 拆 分 会 面临 很 多 问 
题 ， 例 如 服务 间 如 何 通信 、 使 用 什么 协议 、 是 不 是 长 链接 、 服 务 间 如 何 发 现 其 他 依赖 服务 、 
负载 策略 是 什么 、 服 务 调 用 的 链 路 如 何 跟踪 、 各 个 服务 的 压力 如 何 监控 、 如 此 多 的 服务 如 何 
进行 配置 更 新 等 。 还 好 这 些 问 题 可 以 通过 一 个 完善 的 微服 务 框 架 进 行 解决 ， 例 如 Spring 
Cloud, 4A] 8-5 所 示 。 


反 向 代理 及 


微服 务 治理 组 件 
y 
配置 服务 | 注 路 由 服务 业务 服务 A 
H 
m s 
| 加 一 
| zy 
治理 组 件 链 路 跟踪 服务 监控 业务 服务 B 
所 用 存储 “| 上 
<—— 一 | 
业务 中 间 件 
业务 所 用 数据 请 文件 服务 CDN 缓存 
图 8-5 ”微服 务 集群 
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现在 系统 中 的 服务 已 经 拆 分 成 了 微服 务 体系 ， 月 
一 些 比较 耗 时 或 者 实时 性 不 高 的 业务 ， 可 能 需要 使 
的 任务 可 能 需要 分 布 式 定 时 任务 组 件 进行 处 理 
系统 又 会 引入 一 系列 功能 组 件 ， 如 图 


IP 及 DNS 


8-6 所 示 。 


微服 务 治理 
组 件 


第 8 章 服务 架构 


及 务 间 的 通信 可 能 存在 一 些 特殊 情况 ， 例 如 


消息 队列 进行 处 理 


EE， 还 有 日 志 


体系 也 需要 聚合 起 来 进行 跟踪 ， 这 样 


， 有 一 些 需 要 定时 执行 


业务 组 件 


文件 服务 CDN 


消息 队列 


3 


分 布 式 任务 


© 


we © 


集成 和 镜像 等 能 力 以 畏 
及 部 分 持续 集成 和 镜像 的 内 容 
所 示 。 


图 8-6 功能 组 件 及 微服 务 集群 
现在 系统 已 经 非常 庞大 了 ， 所 有 的 程序 是 分 模块 的 ， 


例 ， 甚 至 每 个 模块 都 有 自己 独立 的 数据 库 。 每 个 服务 使 月 


并且 每 个 模块 都 有 很 多 个 服务 实 


了 很 多 种 业务 组 件 ， 服 务 间 的 通信 
也 需要 RPC 或 消息 队列 ， 这 对 运 维 管理 提出 了 很 高 的 挑战 ， 所 以 这 个 系统 还 需要 添加 持续 


目的 是 让 研发 人 员 从 运 维 角度 


助 运 维 的 工作 ， 让 系统 可 以 实现 自动 化 部 署 并 且 更 加 灵活 。 本 书 会 涉 
里 解 服务 集群 的 运行 ， 如 图 


8-7 
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反 向 代理 及 
负载 


IP 及 DNS 


微服 务 体系 
微服 务 治 理 业务 服务 
组 件 
> 
持续 集成 及 
镜像 


a ee. ee 


日 志 搜集 及 业务 组 件 


展示 


图 8-7 运 维 体系 、 组 件 及 微服 务 集群 

通过 以 上 这 些 操作 ， 这 个 系统 已 经 做 得 非常 强大 了 ， 并 且 各 个 模块 职责 清晰 ， 单 独 扩展 能 
力 强 ， 持 续集 成 可 降低 人 工 的 工作 量 ， 镜 像 技术 使 系统 更 加 灵活 。 此 时 ， 研 发 工程 师 可 以 非常 
轻松 地 在 自己 所 负责 的 模块 中 进行 开发 工作 而 不 用 担心 框架 的 问题 ， 而 架构 师 则 可 以 通过 框架 
治理 等 各 个 可 视 化 界面 来 管控 这 么 庞大 的 系统 集群 。 
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Spring Cloud 是 一 套 微服 务 治理 框架 ， 正 如 前 面 提 到 的 ， 如 果 把 一 个 传统 架构 的 程序 拆 分 为 
一 个 一 个 小 的 微服 务 ， 那 么 出 现 的 治理 和 使 用 上 的 问题 就 可 以 通过 Spring Cloud 解决 。 

Spring Cloud 提供 了 服务 发 现 、 配 置 管理 、 消 息 总 线 、 负 载 均衡 、 断 路 器 、 链 路 跟踪 、 数 据 
监控 等 微服 务 治理 能 力 ， 使 微服 务 集群 可 以 全 面 地 被 管理 和 组 合 起 来 。 同 时 Spring Cloud 各 个 
组 件 是 基于 Spring Boot 的 ， 这 些 能 力 可 以 通过 Spring Boot 的 简单 配置 实现 。 

本 章 使 用 Spring Cloud 的 Edgware.SR2 RAS. Spring Cloud 的 可 选 组 件 很 多 ， 书 中 选择 其 
中 的 一 部 分 进行 演示 ， 例 如 Eureka 和 Zookeeper 都 可 以 作为 服务 发 现 组 件 ， 书 中 只 演示 


Eureka. 


a 


9.1 Eureka 


Eureka 是 Spring Cloud 的 服务 注册 发 现 组 件 ， 微 服务 集群 内 的 业务 服务 都 通过 Eureka 进行 注 
册 ， 这 样 Eureka 上 就 保留 了 业务 服务 的 名 字 和 地 


址 。 如 果 集 群 内 的 服务 间 需 要 互相 调用 ， 通 过 i starter roe D 
= va de H ep Zyl 人 (办 
Eureka 上 已 经 注册 的 信息 就 能 查 到 目标 服务 的 地 址 VY, 
JKS, 从 而 实现 集群 内 的 服务 间 调 用 g Service URL _| http://start.spring.io ~] 
Name SpringCloudEureka | 
9.1.1 Eureka 基础 使 用 iene 
Location D:\projects\JavaDeveloperMap\SpringCloudEureka Browse 
首先 搭建 一 个 单 节点 的 Eureka， 然 后 创建 一 we a T ge | 
个 业务 服务 ， } 有 把 业务 服务 注册 到 Eureka TERS Java Version: 8 ~ Language: Java ~ 
之 后 就 可 以 通过 Eureka 的 可 视 化 页 面 查看 服务 的 mee = | 
列表 ， 并 且 通 过 RestAPI 可 以 查看 服务 的 详细 注 veson forsna ] 
册 信 息 Description | Eureka project for Spring Cloud | 
(1) 创建 Eureka 服务 端 ee ie Ce 
I 


于 Eureka 服务 端 也 是 一 个 Spring Boot T. asd project to working sets ma 
程 ， 所 以 按照 Spring Boot 工程 的 方式 去 创建 ， 如 ae 
9-1 所 示 。 

然后 在 接 下 来 的 组 件 选 择 中 选择 Eureka © a Fn SA 
Server, WK] 9-2 所 示 。 


Ds 


9-1 创建 Eureka 工程 


O 本 章 介绍 的 组 件 ， 大 部 分 是 通过 Dalston.SR4 版 本 进行 编写 ， 之 后 又 升级 到 Edgware.SR2 版 本 的 ， 所 以 在 这 两 个 版 本 中 ， 程 序 
实现 基本 是 通用 的 。 但 是 由 于 Spring Cloud 版 本 更 新 很 快 ， 如 果 读者 拿 到 本 书 时 使 用 的 Spring Cloud 版 本 不 是 这 两 个 ， 可 能 会 发 生 不 适 
配 的 情况 。 

© 业务 服务 从 Eureka 获取 到 的 服务 列表 信息 会 自己 进行 缓存 ， 而 不 是 每 次 调用 都 要 请 求 Eureka 获取 列表 。 
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New Spring Starter Project Dependencies 


Spring Boot Version: | 1.5.11 ~ 
Frequently Used: 


Actuator MyBatis MySQL 
Redis Security Web 


Available: Selected: 


eureka 


X Eureka Server 


~ Cloud Discovery 


Eureka Discovery 


[J] Eureka Server 


4 


Pivotal Cloud Foundry 


Service Registry (PCF) 


Make Default Clear Selection 


® < Back Next > Cancel 
9-2 Eureka 依赖 选择 


创建 后 工程 的 pom 文件 如 下 : 


<?xml version="1.0" encoding="UTF-8"?> 

<project xmlns="http://maven.apache.org/POM/4.0.0"xmlns:xsi="http://www.w3.org/200 1/XMLSchema-instance" 
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 
http://maven.apache.org/xsd/maven-4.0.0.xsd"> 
<model Version>4.0.0</model Version> 


<groupld>com.javadevmap</groupId> 
<artifactld>SpringCloudEureka</artifactld> 
<version>0.0.1-SNAPSHOT</version> 
<packaging>jar</packaging> 


<name>SpringCloudEureka</name> 
<description>Eureka project for Spring Cloud</description> 


<parent> 
<groupld>org.springframework.boot</groupId> 
<artifactld>spring—boot-starter—parent</artifactld> 
<version>1.5.11.RELEASE</version> 
<relativePath/> <!—— lookup parent from repository 一 > 
</parent> 


<properties> 
<project. build.sourceEncoding>UTF-8</project.build.sourceEncoding> 
<project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding> 
<java.version>1.8</java.version> 
<spring—cloud.version>Edgware.SR2</spring—cloud.version> 

</properties> 


<dependencies> 
<dependency> 
<groupld>org.springframework.cloud</groupId> 
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修改 Eureka 工程 的 配置 文件 ， 通 过 serverport 和 spring.application.name 给 Eureka 服务 设置 
端口 号 和 服务 名 。eureka.instance.hostname 是 服务 实例 主机 . BH, A 
Eureka 服务 ， 


<artifactId>spring-cloud-starter-eureka-server</artifactId> 
</dependency> 


<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-test</artifactId> 
<scope>test</scope> 
</dependency> 
</dependencies> 


<dependencyManagement> 
<dependencies> 
<dependency> 
<groupId>org.springframework.cloud</groupId> 
<artifactId>spring-cloud-dependencies</artifactId> 
<version>$ {spring-cloud.version}</version> 
<type>pom</type> 
<scope>import</scope> 
</dependency> 
</dependencies> 
</dependencyManagement> 


<build> 
<plugins> 
<plugin> 
<groupld>org.springframework.boot</groupId> 
<artifactld>spring-boot-maven—plugin</artifactld> 
</plugin> 
</plugins> 
</build> 


</project> 


% 9% Spring Cloud 


mot 


所 以 使 用 localhost 来 指 代 主机 名 。 由 于 是 单 节 点 ， 所 以 ; 


为 Eureka 服务 的 地 址 ， 这 里 就 是 Eureka 服务 本 身 。 


server: 
port: 18001 
spring: 
application: 


name: eureka-server 


eureka: 
instance: 


hostname: localhost 


client: 


register—-with-eureka: false 
fetch-registry: false 
service-url: 
defaultZone: http://localhost: 18001/eureka/ 


例 是 在 本 机 演示 单 节点 


过 eureka.client 下 面 的 设 
置 register-with-eureka 和 fetch-registry 暂时 关闭 了 Eureka pee 自己 注册 的 能 力 ，service-url 
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最 后 一 步 就 是 添加 局 动 类 的 注解 : 


import org.springframework.boot.SpringA pplication; 

import org.springframework.boot.autoconfigure.SpringBootA pplication; 

import org.springframework.cloud.netflix.eureka.server.EnableEurekaServer; 

@EnableEurekaServer 

@SpringBootApplication 

public class SpringCloudEurekaApplication { 

public static void main(String[] args) { 

SpringApplication.run(SpringCloudEurekaApplication.class, args); 


} 

} 
在 程序 启动 类 中 添加 了 注解 @EnableEurekaServer， 用 于 开启 Eureka 的 服务 端 能 力 。 这 样 
一 个 Eureka 服务 端 就 配置 好 了 。 可 以 使 用 启动 Spring Boot 工程 的 方式 启动 此 Eureka 服务 。 

(2) 创建 Eureka 客户 端 

Eureka 的 客户 端 也 是 一 个 Spring Boot 工程 ， 只 是 工程 内 引用 Eureka 客户 端 依赖 ， 然 后 配置 
好 服务 注册 的 相关 配置 ， 即 可 完成 服务 注册 。 

创建 一 个 Spring Boot 工程 SpringCloudServiceProvider。 在 工程 中 引入 Eureka 的 客户 端 
依赖 。 


<dependency> 
<groupld>org.springframework.cloud</groupId> 
<artifactId>spring-cloud-starter-eureka</artifactld> 
</dependency> 


修改 此 工程 的 ym 配置 文件 ， 配 置 本 服务 的 端口 和 名 称 ， 并 且 配 置 连接 Eureka 服务 端的 地 


server: 
port: 18010 
spring: 
application: 
name: service-provider 
eureka: 
instance: 
hostname: localhost 
client: 
service-url: 
defaultZone: http://localhost:18001/eureka/ 


在 启动 类 中 通过 注解 @EnableEurekaClient2 开 启 服务 注册 能 力 。 这 样 ， 就 完成 了 一 个 业务 服 
务 的 Eureka Client 配置 。 
(3) 观察 Eureka 服务 注册 信息 
Eureka 服务 注册 中 心 和 一 个 业务 服务 均 已 经 配置 完毕 ， 下 面 启动 这 两 个 服务 ， 然 后 访问 
Eureka 的 可 视 化 页 面 ， 即 可 看 见 服务 列表 ， 如 图 9-3 所 示 。 


本 章 用 到 的 新 依赖 包 和 注解 较 多 ， 使 用 注解 时 一 般 都 需要 import 相应 的 资源 。 由 于 本 书 使 用 顺序 的 方式 讲述 每 个 知识 点 ， 所 以 
import 导入 的 内 容 和 当时 讲解 的 组 件 一 般 都 有 关系 ， 当 添加 注解 时 如 果 书 中 没有 明确 说 明 引 入 的 资源 包 ， 一 般 IDE 默认 提示 的 资源 包 都 
可 以 使 用 ， 但 大 家 还 要 多 注意 分 辨 。 
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© spring Eureka HOME LAST1000 SINCE STARTUP 


System Status 


nvironment test Current time 2018-05-07T15:26:48 +0800 


Data center default Uptime 00:00 


Lease expiration enabled false 


Renews threshold 3 


Renews (last min) 0 
DS Replicas 
Instances currently registered with Eureka 


Application AMIs Availability Zones Status 


SERVICE-PROVIDER n/a (1) @ UP (1)- 


General Info 


324mb 


test 


4 


147mb (45%) 


00:00 


registered-replicas 


unavailable-replicas 


available-replicas 


DS 


9-3 Eureka 页 面 
可 见 ， 客 户 端 服务 SERVICE-PROVIDER 已 经 注册 到 了 Eureka Server 上 。 


9.1.2 ”配置 服务 注册 信息 


现在 已 经 把 业务 服务 注册 到 Eureka 上 了 ， 但 是 如 果 想 修改 业务 服务 注册 到 Eureka 上 的 信 
县， 例如 在 Eureka 页 面 上 直接 点 击 业务 服务 的 链接 ， 就 可 以 看 到 业务 服务 的 说 明 。 

要 想 实现 这 个 能 力 ， 必 须 弄 清楚 几 个 问题 : 业务 服务 向 Eureka 服务 注册 了 什么 信息 、 点 击 
的 链接 实际 打开 的 是 哪个 注册 信息 中 的 内 容 以 及 配置 一 个 应 用 服务 的 说 明 信 息 。 下 面 来 实现 这 


个 能 


(1) 通过 Eureka RestAPI 获取 服务 信息 
可 以 通过 Eureka 对 外 提供 的 接口 ， 查 看 当前 Eureka 上 的 服务 注册 信息 。 访 问 http:/localhost: 
18001/eureka/apps 可 以 看 到 如 下 输出 。 


<applications> 
<versions delta>1</versions delta> 
<apps hashcode>UP 1 </apps hashcode> 
<application> 
<name>SERVICE-PROVIDER</name> 
<instance> 
<instanceId>10.10.14.80:service-provider:18010</instanceId> 
<hostName>localhost</hostName> 
<app>SERVICE-PROVIDER</app> 
<ipAddr>10.10.14.80</ipAddr> 
<status>UP</status> 
<overriddenstatus> UNKNOWN</overriddenstatus> 
<port enabled="true">18010</port> 
<securePort enabled="false">443</securePort> 
<countryId>1</countryId> 
<dataCenterInfo class="com.netflix.appinfo.InstanceInfo$DefaultDataC enterInfo"> 
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<name>MyOwn</name> 
</dataCenterInfo> 
<leaseInfo> 
<renewalIntervalInSecs>30</renewalIntervalInSecs> 
<durationInSecs>90</durationInSecs> 
<registrationTimestamp>1525678611057</registrationTimestamp> 
<lastRenewalTimestamp>1525678611057</lastRenewalTimestamp> 
<evictionTimestamp>0</evictionTimestamp> 
<serviceUpTimestamp> 152567861 1058</serviceUpTimestamp> 
</leaseInfo> 
<metadata> 
<management.port>18010</management.port> 
<jmx.port>55186</jmx.port> 
</metadata> 
<homePageUrl>http://ocalhost:18010/</homePageUrl> 
<statusPageUrl>http://localhost:18010/info</statusPage Url> 
<healthCheckUrl>http://localhost: 18010/health</healthCheck Url> 
<vipAddress>service—provider</vipA ddress> 
<secure VipAddress>service—-provider</secure VipAddress> 
<isCoordinating DiscoveryServer>false</isCoordinatingDiscoveryServer> 
<lastUpdatedTimestamp>1525678611058</lastUpdatedTimestamp> 
<lastDirtyTimestamp>1525678610862</lastDirtyTimestamp> 
<actionType>ADDED</actionType> 


</instance> 
</application> 
</applications> 
在 此 返回 信息 中 ， 最 外 层 标 签 是 applications， 记 录 了 Eureka 上 所 有 的 服务 ; 第 2 层 的 


application 标签 记录 了 某 个 服务 的 所 有 程序 实例 ， 其 中 Instance 标签 是 具体 的 服务 实例 的 信息 ， 


这 个 信息 可 以 通过 应 用 服务 的 eureka.instance 属性 进行 配置 。 


(2) 配置 服务 显示 信息 


通过 对 业务 服务 添加 actuator 依赖 ， 可 以 启动 业务 服务 的 端点 显示 。 然 后 在 yml 配置 文件 


中 添加 服务 的 显示 信息 。 
info: 
author: hw 


book: javadevmap 
project: service provider demo 


这 样 当 访 


{"author":"hw","book":"javadevmap", 


问 此 业务 服务 端点 http://10.10.14.80:18010/info 时 ， 可 以 得 到 如 下 输出 : 


project":"service provider demo"} 。 


(3) Eureka 页 面 点 击 服务 链接 显示 信息 
点 击 Eureka 页 面 中 的 服务 链接 实际 是 打开 服务 配置 中 的 status-page-url 属性 ， 这 个 地 址 默 
认 是 “http:/ 主 机 名 :端口 /info” 的 形式 。 实 现 点 击 链接 即 可 看 到 服务 信息 的 方法 有 4 种 ， 这 4 种 


方法 的 效果 相同 ， 有 具体 选择 哪 种 方法 根据 实际 情况 决定 。 
1) 如 果 已 经 正确 地 配置 了 hostname 的 解析 ， 那 么 点 击 Eureka 页 面 链接 时 ， 会 自动 跳 转 到 


服务 的 info 端点 ， 并 且 显 示 服 务 信 息 ， 本 例 中 hostname 使 用 的 是 localhost， 所 以 可 以 正确 地 打 


开 服 务 信息 页 。 
2) 不 配置 
如 如 下 设置 。 
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host 解析 ， 而 是 在 eureka client 中， 设置 eureka.instance.hostname 为 IP 地 址 ， 例 


FE == 


J 9% Spring Cloud 
eureka: 
instance: 
hostname: $ {spring.cloud.client.ipAddress} 


3) 不 使 用 host 解析 ， 也 不 配置 hostname 为 IP 地 址 ， 而 是 使 用 另 一 个 配置 。 这 个 配置 可 以 
FEE hostname 的 地 方 全 部 替换 为 服务 IP。 


eureka: 
instance: 
hostname: service-provider 
prefer—ip-address: true 


生 值 完成 配置 ， 这 里 通过 只 网 改 此 字段 ， 把 服 


Hal 


4) 直接 修改 eureka.instance.status-page-url 
务 说 明 指 向 了 其 他 的 地 址 。 


eureka: 
instance: 
hostname: service-provider 
prefer-ip-address: true 
status—page-url: http://www.javadevmap.com 


“YR, instance 还 有 其 他 配置 项 用 来 修改 服务 在 Eureka 上 的 注册 信息 ， 例 如 修改 
eureka.instance.instance-id 可 以 修改 服务 在 Eureka 页 面 上 的 显示 等 。 


9.1.3 ”基于 Host 的 高 可 用 Eureka 


基于 Host 进行 Eureka 的 高 可 用 配置 ， 需 要 提供 多 个 可 以 解析 的 Host 地 址 ， 在 Eureka 集群 

中 的 不 同 Eureka 实例 中 使 用 不 同 的 Host 地 址 作为 hostname， 并 且 在 各 自 服务 的 defaultZone ' 

配置 其 他 Eureka 服务 的 地 址 。 
例如 配置 两 台 Eureka 服务 的 集群 ， 其 中 服务 A 的 hostname 为 eureka-serverA, defaultZone 

地 址 为 http://eureka-serverB:18002/eureka/; 服务 B 的 hostname 为 eureka-serverB defaultZone 地 

址 为 http://eureka-serverA:18001/eureka/。 然 后 在 业务 服务 的 defaultZone 中 配置 两 台 Eureka 服务 

的 地 址 即 可 。 

(1) 配置 Host 解析 

在 服务 器 的 hosts 文件 中 ， 使 用 正确 的 他 地 址 配置 host 解析 。 

172.17.238.237 eureka-serverA 

172.17.238.237 eureka-serverB 


(2) Eureka A 中 的 配置 


server: 
port: 18001 
eureka: 
instance: 
hostname: eureka-serverA 
instance-id: ${spring.cloud.client.ipAddress}:$ {server.port} 
client: 
register-with-eureka: true 
fetch-registry: true 
service-url: 
defaultZone: http://eureka-serverB: 18002/eureka/ 
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(3) Eureka B 中 的 配置 


server: 
port: 18002 
eureka: 
instance: 
hostname: eureka-serverB 
instance-id: ${spring.cloud.client.ipAddress}:$ {server.port} 
client: 
register-with-eureka: true 
fetch-registry: true 
service-url: 
defaultZone: http://eureka-serverA:18001/eureka/ 


(4) 业务 服务 的 配置 


server: 
port: 18010 
spring: 
application: 
name: service-provider 
eureka: 
instance: 
hostname: service-provider 
instance-id: ${spring.cloud.client.ipAddress}:$ {server.port} 
prefer—-ip-address: true 
client: 
service-url: 
defaultZone: http://eureka-serverA:18001/eureka/,http://eureka-serverB: 18002/eureka/ 


info: 
author: hw 
book: javadevmap 
project: service provider demo 


这 样 访问 其 中 任意 一 台 Eureka， 即 可 看 到 业务 服务 SERVICE-PROVIDER 。 由 于 开 
Eureka 服务 的 自 注 册 功 能 ， 所 以 还 能 看 到 两 台 Eureka 服务 。 


9.1.4 ”基于 下 的 高 可 用 Eureka 


使 用 上 节 的 方法 可 以 搭建 Eureka 集群 ， 但 是 配置 Host 解析 和 Eureka 集群 中 多 实例 相互 配置 
的 工作 比较 麻烦 。 下 面 提 供 一 种 基于 IP 的 Eureka 集群 方案 ， 该 方案 可 以 实现 同样 的 Eureka 集群 
效果 ， 并 且 避 免 了 多 台 Eureka 配置 属性 不 同 的 问题 ， 前 提 是 Eureka 部 署 在 不 同 的 服务 器 -| 

(1) Eureka 服务 端 配置 


server: 
port: 18001 
spring: 
application: 
name: eureka-server 
eureka: 
instance: 
hostname: eureka-server 
instance-id: ${spring.cloud.client.ipAddress}:$ {server.port} 
prefer-ip-address: true 
client: 


Ir 
4 


T 


| .o 
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fetch-registry: true 
register-with-eureka: true 
region: javadevmap 
availability—zones: 
javadevmap: map_eureka 
service-url: 
map_ eureka: http://172.17.238.237:18001/eureka/,http://172.17.238.239:18001/eureka/ 


上 面 的 配置 中 ， 开 局 Eureka 的 自 注 册 能 力 ; 在 配置 Eureka 集群 地 址 时 ， 使 用 了 
eureka.client.region 的 方式 来 替代 defaultZone 的 方式 配置 Eureka 服务 器 的 地 址 。Eureka 的 服务 集群 
没有 使 用 相互 配置 的 方法 ， 而 是 把 全 量 服务 地 址 都 号 到 一 起 ， 这 样 当 集 群 中 有 多 台 Eureka 服务 器 


时 ， 避 免 了 多 个 实例 配置 值 不 同 的 麻烦 ， 上 只 要 在 对 应 IP 地 址 的 服务 器 中 启动 Eureka 服务 即 可 。 


(2) 应 用 服务 配置 
应 用 服务 的 配置 还 是 连接 Eureka 服务 集群 的 地 址 。 


eureka: 
instance: 
hostname: service-provider 
instance-id: $ {spring.cloud.client.ipAddress}:$ {server.port} 
prefer-ip-address: true 
client: 
region: javadevmap 
availability—zones: 
javadevmap: map_eureka 
service-url: 
map_ eureka: http://172.17.238.237:18001/eureka/,http://172. 17.238.239:18001/eureka/ 


(3) 页 面 展示 如 图 9-4 所 示 。 


© | © 47.95.113.117:1800 x 


© spring Eureka HOME LASsT1000SINCE STARTUP 


System Status 


Environment t test 2018-05-07T17:56:37 +0800 


Data center default 00:00 


ion enabled false 


DS Replicas 


Instances currently registered with Eureka 


Application AMIs Availability Zones Status 
EUREKA-SERVER n/a (2) 2 UP (2) - 172.17.238.239:18001 , 172.17.238237:18001 
SERVICE-PROVIDER n/a (1) (1) UP (1) - 172.17.238.237:1801 


General Info 
Name Value 


90mb 


test 


2 


52mb (57%) 


00:00 


图 9-4 Eureka 页 面 服务 列表 


© Region 表示 区 域 ， 这 里 设 定 的 区 域 为 javadevmap; map eureka 表示 集群 分 组 。 在 这 里 仅仅 作为 演示 的 写法 ， 效 果 和 


defaultZone 是 同样 的 。 当 然 region 还 有 其 他 含义 ， 只 是 这 里 没有 使 
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本 节 用 到 了 Eureka 最 主要 的 能 力 ， 
间 的 配置 项 S 等 ， 这 些 就 需要 在 日 常 工作 中 更 详 
看 到 Eureka 配置 项 的 作用 。 


当然 Eureka 


9.2 Ribbon 5 Feign 


当 把 一 个 传统 架构 的 服务 进行 微服 务 拆 分 后 ， 


统 的 正常 运转 是 需要 各 个 微服 务 模块 贡献 其 能 
了 服务 间 的 调用 。 
服务 调用 还 有 一 层 意 义 就 是 服务 数据 的 组 装 ， 


责 订单 模块 ， 如 果 要 查询 某 一 用 户 生 成 了 


TATÀ 


还 有 


些 更 计 


每 个 微服 务 都 负 
， 组 成 一 个 业务 的 最 终 


例如 一 个 服务 负责 


接 从 用 户 模块 调用 订单 模块 的 接口 ， 会 使 


= = 
页 


F 细 的 配置 项 


部 分 功 能 ， 
形态 的 ， 和 


昌 户 模块 ， 男 一 个 服务 负 
上 ， 会 涉及 两 个 模块 的 数据 组 装 问题 。 如 果 直 


用 户 模块 的 业务 和 订单 服务 造成 耦合 ， 从 而 破坏 用 户 


， 例 如 设置 更 新 时 
细 地 去 了 解 ， 可 以 在 编写 代码 时 根据 IDE 的 提示 


但 是 整个 系 


模块 的 独立 性 ， 所 以 这 时 候 提炼 出 来 一 个 服务 ， 专 门 负责 调 


装 ， 从 而 保证 最 底层 核心 服务 的 纯净 。 

Eureka 的 服务 注册 发 现 能 力 是 服务 调 
地 址 清和 
用 Feign 来 简 


化 服务 间 调 
9.2.1 Ribbon 


用 的 基础 ， 服 务 消费 者 通过 
继而 实现 服务 间 调 用 。 可 以 使 用 Ribbon 进行 带 负 载 均衡 9 的 服务 间 调 用 ， 还 
的 写法 ，Feign 默认 集成 了 Ribbon。 


先 创建 一 个 服务 的 消费 者 类似 数据 组 装 层 )， 用 服务 消费 者 
核心 功能 模块 )， 完 成 基础 的 Ribbon 调用 ;然后 为 服务 提供 者 再 添加 一 个 实例 。 


的 负载 情况 。 
(1) 添加 服务 消费 


者 依赖 


<dependency> 
<groupId>org.Springframework.boot</groupId> 
<artifactId>spring-boot-starter-web</artifactId> 

</dependency> 

<dependency> 
<groupId>org.springframework.cloud</groupId> 


<artifactId>spring-cloud-starter-eureka</artifactId> 


</dependency> 
<dependency> 
<groupId>org.springframework.cloud</groupId> 


<artifactId>spring-cloud-starter-ribbon</artifactId> 


</dependency> 
(2) 添加 Eureka 相关 配置 


© Eureka 中 已 注册 的 服务 信息 的 移 除 在 极端 情况 下 的 反应 时 间 


会 非常 长 ， 例 如 使 


那么 快 地 更 新 业务 服务 状态 变化 ，eureka.server.enable-self-preservation=false 配置 项 可 以 


时 间 ， 所 以 应 尽量 使 
日 当 有 多 个 服务 
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闭 业 务 


负载 策略 ， 


shutdown 端口 等 方式 正常 关 
提供 者 时 ， 负 载 均衡 会 通过 其 


调 


民 务 ， 因 为 正常 


关闭 会 有 移 除 


多 人 台 服 务 提 供 者 的 实例 ， 而 不 是 仅仅 调 


新 建 一 个 Spring Boot 工程 SpringCloudServiceConsumer， 添 加 如 下 依赖 。 


kill 命令 杀 掉 业务 
关闭 Eureka 的 数据 
民 务 节点 逻辑 执行 。 


业务 核心 服务 3 


且 完 成 数据 的 组 


务 


民 
组 在 


Eureka 找到 服务 提供 者 的 


可 以 使 


FE 独 调用 服务 的 提供 者 (类 似 


看 一 下 Ribbon 


于 服务 间 调用 是 基于 Eureka 的 服务 发 现 注 册 机 制 的 ， 所 以 服务 消费 者 也 要 注册 到 Eureka 


节点 ，Eureka 可 能 没有 
保护 ， 但 是 仍 存在 延迟 


人 


Hg 


的 


E o 


55 -> 


F 9% Spring Cloud 


一 节 服 务 提 供 者 的 Eureka 配置 进行 修改 。 不 


上 ， 才 能 获取 服务 提供 者 的 信息 。 这 里 可 以 参照 上 
Pa A Ty 
FF Eureka 可 以 看 到 相关 注 ; 


Application 


9-5 所 示 。 


Availability Zones 


Was, ones 


AMIs 


i 


EUREKA-SERVER n/a (2) (2) 


是 服务 名 字 和 端口 号 ， 消 费 者 服务 名 使 用 service-consumer, H 


‘Status 


UP (2)- 172 


SERVICE-CONSUMER n/a (1) (1) 


up (1) - 172 


SERVICE-PROVIDER n/a(1) (1) 


UP (1) - 172.17.238.237:18010 


图 9-5 Eureka 服务 列表 


(3) 服务 提供 者 提供 可 调用 接口 


号 使 用 18020。 打 


对 服务 提供 者 进行 改造 ， 把 前 面 使 用 过 的 SpringBootMybatis 工程 的 代码 移植 过来， 从 而 


使 SpringCloudServiceProviderS 工 程 具备 了 用 户 查 询 接口 、 日 志 记 录 等 能 力 ， 这 样 Provider 工程 
就 成 为 了 注册 到 Eureka 上 的 负责 用 户 模 块 的 微服 务 。 


(4) 服务 消费 者 调用 


配置 


Lo 


@Bean 

@LoadBalanced 

RestTemplate restTemplate() { 
return new RestTemplate(); 


=i 
=j 


Spring 管 


} 
(5) 服务 消费 
在 Consumer 工程 
接口 ， 从 接口 返回 的 数据 ， 
成 数据 的 模板 化 返回 9。 


者 逻辑 添 加 
， 添 加 Service 接 
’ 选取 需要 的 数据 ， sical 


类 和 它 的 实现 类 ， 
回 给 Controller 
同时 需要 在 Consumer 工程 


Provider 服务 的 返回 数据 ， 


public interface ConsumerService { 
public DomainUser getUserFromProvider(int id); 


} 


import org.springframework.web.client.RestTemplate; 
@Service 


这 个 类 的 数据 结构 和 Provider 中 的 相同 ， 


在 实现 类 中 调 月 


类 ， 


然后 在 Controller 类 
中 建立 一 个 DomainUser 类 ， 用 于 承接 


public class ConsumerServiceImpl implements ConsumerService { 


@Autowired 
private RestTemplate restTemplate; 


@Override 
public DomainUser getUserFromProvider(int id) { 
Result<DomainUser> result = restTemplate. 


1k A FER 


在 SpringCloudServiceConsumer 的 启动 类 中 ， 添 加 如 下 代码 ， 使 调用 的 RestTemplete 实例 被 


H Provider 服务 的 


类 中 完 


getForObject("http://SERVICE-PROVIDER/user/"+id, Result.class); 


if(result.getResultCode()==200) { 
return (DomainUser)result.getData(); 


O 移植 过 程 中 注意 修改 对 应 的 包 名 ， 否 则 无 法 编译 或 程序 运行 出 现 错误 。 

O 在 实际 项 目 中 ， 把 此 工程 名 改 为 带 有 User 标记 的 工程 名 更 为 合适 ， 因 为 那样 更 能 直观 地 表达 这 个 服务 提供 者 负责 的 模块 是 什 
么 。 这 里 没有 修改 工程 名 是 因为 本 章 不 会 出 现 其 他 能 力 的 服务 提供 者 ， 并 且 用 消费 者 和 提供 者 作为 工程 名 ， 对 于 新 手 更 加 直观 。 

© 模板 化 返回 和 请 求 的 切面 日 志 记录 需要 添加 进 工程 ， 以 后 的 Spring Boot 业务 服务 都 默认 这 些 已 经 添加 进 工程 。 
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}else { 
return null; 
} 
} 
} 
添加 Controller 类 逻辑 如 下 : 
@RestController 


@RequestMapping(value="/consumer") 
public class ConsumerController { 
@Autowired 
private ConsumerService service; 


@RequestMapping(value="/{Id}",method=RequestMethod.GET) 

public Result<DomainUser> getUser(@PathVariable("Id") int id) { 
DomainUser user = service.getUserFromProvider(id); 
Result<DomainUser> result = null; 


if(user!=null) { 
result = new Result<>(ResultCode.OK, user); 
yelse { 
result = new Result<>(ResultCode.Not_Found); 
} 
return result; 
} 
} 
上 面 的 代码 在 Service 中 使 用 RestTemplete 的 getForObject 方法 调用 服务 提供 者 的 接口 ， 由 
于 服务 都 已 经 注册 到 Eureka 上 ， 所 以 Http 链接 上 可 以 直接 使 用 服务 的 名 字 2。 在 方法 中 期 望 返 
回 一 个 Result 类 型 的 数据 ， 所 以 在 请 求 参数 中 设置 了 Result 类 型 ， 然 后 根据 返回 的 信息 码 判断 
是 否 成 功 ， 如 果 成 功 则 可 以 得 到 DomainUser 类 型 的 实例 ， 然 后 Consumer 服务 再 对 数据 进行 封 
闭 返 回 。 
通过 用 浏览 器 访问 Consumer 服务 的 接口 完成 调用 ， 但 并 没有 返回 期 望 得 到 的 输出 结果 ， 并 


Consumer 服务 报错 了 。 但 是 排查 Provider 服务 的 输出 


据 。 那 么 问题 出 在 哪 


E? 下 面 从 问题 排查 的 角度 来 逐步 分 析 上 而 


这 个 问题 。 
(6) Ribbon 获取 数据 的 几 种 方法 
由 于 查看 Provide 日 志 ， 发 现 Provider GAIEK 


返回 


了 数据 ， 


8 现 的 问题 ， 然 


] 志 9 发 现 此 服务 已 经 正确 返回 了 数 


那么 可 能 


尝试 去 解决 


怀疑 ，Consumer 


是 否 正确 收 到 了 数据 。 所 以 对 Service 中 的 getUserFromProvider 方法 进行 改造 。 
@Override 
public DomainUser getUserFromProvider(int id) { 
String retString = restTemplate.getForObject("http://SERVICE-PROVIDER/user/"+id, String.class); 
log.info(""consumer receive is " + retString); 
return null; 
j 
通过 日 志 查 看 ， 会 发 现 Consumer 服务 已 经 成 功 收 到 了 数据 。 那 么 问题 可 能 就 出 在 Json 数 
O 可 以 使 用 卫 端口 的 方式 进行 调用 ， 即 把 例子 中 的 服务 名 改 为 P 和 端口 ， 这 里 就 不 再 袭 述 。 


© 在 你 无 法 对 程序 进行 断 点 跟踪 的 
206 


THK, 


志 会 帮 你 的 大 忙 。 


第 9 章 Spring Cloud 
据 到 类 实例 的 转化 过 程 。 
如 果 读 者 仔细 阅读 了 第 1 章 ， 应 该 记得 Java 的 泛 型 模板 和 C++ 的 不 同 ，Java 的 泛 型 会 擦 除 
类 型 。 既 然 RestTemplete 提供 了 根据 类 型 获取 返回 数据 的 接口 ， 那 么 如 果 不 使 用 模板 ， 而 使 用 
定 类 型 来 获取 数据 呢 ? 


所 以 ， 下 面 创建 一 个 确定 类 型 的 类 ， 来 承接 getForObject 方法 返回 的 数据 ， 这 个 确定 类 型 
不 使 用 模板 ， 而 是 直接 包含 一 个 DomainUser 对 象 。 


public class ResultDomainUser { 
private int resultCode; 
private String msg; 
private DomainUser data; 


@Override 
public DomainUser getUserFromProvider(int id) { 


ResultDomainUser result = restTemplate.getForObject("http://SERVICE-PROVIDER/ user/"+ id, 
ResultDomainUser.class); 


if(result.getResultCode()==200) { 
return result.getData(); 
yelse { 
return null; 
} 
} 


通过 Postman 访问 获取 用 户 接 口 ， 可 以 看 到 数据 的 输出 。 如 图 9-6 所 示 。 


» http://47.95.113.117:18040/springcloud/user/7 


Jl 


图 9-6 获取 用 户 信 息 


现在 数据 确实 可 以 返回 了 ， 但 是 这 样 却 破坏 了 模板 化 输出 的 结构 ， 调 用 方 要 针对 每 个 提供 

方 返回 的 数据 提供 两 个 类 ， 来 承接 数据 返回 ， 所 以 还 是 期 望 能 够 使 用 模板 来 实现 数据 传递 的 简 
化 和 标准 化 。 在 Service 实现 类 中 添加 如 下 引用 ， 并 修改 getUserFromProvider 7772 

import org.springframework.core.ParameterizedTypeReference; 

import org.springframework http.HttpMethod; 

import org.springframework http.ResponseEntity; 


o 
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@Override 
public DomainUser getUserFromProvider(int id) { 
ParameterizedTypeReference responseType = new 
ParameterizedTypeReference<Result<DomainUser>>() {}; 
ResponseEntity<Result<DomainUser>> resp = restTemplate.exchange 
(“http://SERVICE-PROVIDER/user/"+id, HttpMethod.GET, null, responseType); 
Result<DomainUser> result = resp.getBody(); 
if(result.getResultCodeQ==200) { 
return (DomainUser)result.getData(); 
yelse { 
return null; 
} 
} 


模板 类 型 应 该 使 用 exchange 方法 获取 ， 并 且 要 在 参数 中 设置 一 个 特殊 的 类 型 ， 不 能 使 用 普 
通 的 类 型 获取 方法 。 通 过 这 样 修改 ， 模 板 又 可 以 使 用 了 。 

(7) 多 台 负 载 

通过 Spring Boot 的 多 环境 配置 ， 用 另 一 个 端口 再 启动 一 个 Provider 实例 92， 如 图 9-7 所 示 。 


Instances currently registered with Eureka 


Application AMIs Availability Zones Status 
EUREKA-SERVER nfa (2) (2) UP (2) - 
SERVICE-CONSUMER n/a (1) (1) UP (1) - 
SERVICE-PROVIDER nfa (2) (2) UP (2) - 172.17 


图 9-7 Provider 服务 多 实例 


周 用 Consumer 服务 接口 ， 观 察 Provider 服务 的 两 台 实 例 是 否 都 得 到 了 调用 。 最 简单 的 办 法 
就 是 观察 日 志 ， 你 会 发 现 两 台 实 例 轮流 打印 日 志 信息 。 
(8) 修改 负载 规则 
默认 的 负载 规则 是 轮 询 的 方式 ， 可 以 在 消费 者 服务 的 配置 类 或 启动 类 中 添加 如 下 代码 修改 
负载 规则 ; 
@Bean 


public [Rule ribbonRule() { 
return new RandomRule(); 


= 


} 


这 段 代码 把 负载 规则 修改 为 随机 策略 。 当 然 Ribbon 的 负载 还 包含 其 他 策略 ， 可 以 进入 工程 
的 ribbon-loadbalancer 依赖 中 查看 更 多 的 负载 策略 。 


9.2.2 Feign 


在 上 一 小 节 中 ， 使 用 Ribbon 完成 了 服务 间 的 调用 。 但 是 读者 可 能 会 发 现 Ribbon 的 写法 稍 
显 麻 烦 ， 而 且 对 于 普 裔 使 用 的 模板 还 要 另外 进行 配置 。 下 面 介绍 一 种 简单 的 实现 服务 间 调 用 的 
组 件 。 


Feign 默认 集成 了 Ribbon， 并 和 Eureka 结合 默认 实现 负载 均衡 的 效果 。 只 要 使 用 接口 注解 
声明 的 方式 就 可 以 实现 接口 调用 的 能 力 。 
(1) 添加 Feign 依赖 


O 如 果 你 的 服务 器 够 多 ， 就 不 用 这 么 麻烦 地 配置 多 环境 ， 只 要 在 另 一 台 服 务 器 上 局 动 一 个 实例 即 可 。 
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FE a 


OR 


按照 Spring Boot 工程 的 惯例 ， 必 须 在 Consumer 工程 中 添加 依赖 。 


<dependency> 
<groupld>org.springframework.cloud</groupId> 
<artifactId>spring-cloud-starter-feign</artifactld> 
</dependency> 


(2) 在 启动 类 中 添加 注解 


import org.springframework.cloud.netflix.feign.EnableFeignClients; 
@EnableFeignClients 


(3) 添加 Feign 接口 定义 


Spring Cloud 


在 接口 类 上 方 ， 使 用 @FeignClient 定义 接口 类 ， 说 明 此 接口 类 使 用 Feign 方法 调用 


SERVICE-PROVIDER 服务 ;然后 在 接口 类 内 部 对 需要 调用 的 Provider 服务 接口 定义 方法 ， 方 法 
的 注解 中 标明 路 径 和 请 求 类 型 ， 方 法 的 参数 标明 传递 的 参数 ， 方 法 的 返回 类 型 就 是 Provider Hk 


务 返回 的 数据 类 型 。 


@FeignClient(value="SERVICE-PROVIDER") 

public interface ConsumerFeign { 
@RequestMapping(value="/user/ {id}",method=RequestMethod.GET) 
public Result<DomainUser> getUser(@RequestParam("id") int id); 


@RequestMapping(value="/user/add",method=RequestMethod.POST) 
public Result<String> addUser(@RequestBody DomainUser user); 
} 
(4) 修改 Service 类 
在 Service 类 中 注入 Feign， 并 且 修 改 Service 类 的 方法 实现 。 
@Service 
public class ConsumerServiceImpl implements ConsumerService { 


@Autowired 
private ConsumerFeign feign; 


@Override 
public DomainUser getUserFromProvider(int id) { 
Result<DomainUser> result = feign.getUser(id); 
if(result.getResultCode()==200) { 
return (DomainUser)result.getData(); 


yelse { 
return null; 
} 
} 
@Override 


public int saveUserToProvider(DomainUser user) { 
Result<String> result = feign.addUser(user); 
if(result.getResultCode()==200) { 
return 1; 
yelse { 
return 0; 


j 
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j 


(5) 修改 Controller 类 

在 Controller 类 中 ， 添 加 add 方法 ， 然 后 检验 其 查询 和 添加 的 调 
@RestController 
@RequestMapping(value="/consumer") 
public class ConsumerController { 


@Autowired 
private ConsumerService service; 


oo 
rf 
Pally 
“Š 
5 


@RequestMapping(value="/{Id}",method=RequestMethod.GET) 
public Result<DomainUser> getUser(@PathVariable("Id") int id) { 
DomainUser user = service.getUserFromProvider(id); 
Result<DomainUser> result = null; 
if(user!=null) { 
result = new Result<>(ResultCode.OK, user); 
yelse { 
result = new Result<>(ResultCode.Not_Found); 
} 


return result; 


} 


@RequestMapping(value="/add",method=RequestMethod.POST) 
public Result<String> addUser(@RequestBody @Valid DomainUser user) { 
Result<String> result = null; 
int ret = service.saveUserToProvider(user); 
if(ret == 1) { 
result = new Result<>(ResultCode.OK); 
yelse { 
result = new Result<>(ResultCode.ERROR); 
} 


return result; 


j 


(6) 调用 结果 
通过 Postman 提交 一 个 Post 请 求 到 Consumer 服务 ， 可 以 看 到 服务 的 日 志 为 : 

2018-04-11 16:55:08.442+0800 INFO c.j.serviceconsumer.config.AopAspect[SpringCloudServiceConsumer], [io— 
18020-exec-2] : com.javadevmap.serviceconsumer.controllers.ConsumerController method = addUser args = 
{"id":null,"address":" Hi ER","age":18,"name":"svn","phoneNum":"12345678901"} 

2018-04-11 16:55:08.458+0800 INFO _ c.j.serviceconsumer.config.AopAspect[SpringCloudServiceConsumer], 


[io-18020-exec-2] : com.javadevmap.serviceconsumer.controllers.ConsumerController method = addUser args = {"id":null, 
"address":"HuDR","age":18,"name":"svn","phoneNum":"12345678901"} ret = {"resultCode":200, "msg":"ok","data" null} 


使 用 Feign 形式 的 服务 调用 ， 可 以 让 程序 的 代码 简洁 很 多 ， 本 节 之 后 的 服务 调用 全 部 使 用 
此 方式 。 


H 
a 


9.3 Hystrix 5 Turbine 


设想 一 种 情况 ， 通 过 Spring Cloud 部 署 了 一 个 服务 集群 ， 前 面 创建 的 Provider 服务 成 为 了 
专门 负责 用 户 信息 处 理 的 服务 ， 它 可 以 对 外 提供 每 秒 1000 次 的 访问 能 力 。 集 群 内 同时 存在 其 他 
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| 


很 多 业务 服务 ， 都 会 调用 


会 瘫痪 ， 这 种 效应 称 为 “雪崩 ”。 


务 状况 和 指标 、 熔 断 条 件 配 置 


Provider 服务 获取 基本 的 月 


I 


Hah. RAA 


FE a 


OR 


T 


Spring Cloud 


天 ， 由 于 一 次 运营 宣传 
活动 非常 成 功 ， 整 个 集群 访问 压力 突然 加 大 ， 集 群 内 其 他 服务 对 Provider 的 压力 超过 了 每 秒 
1000 次 ， 这 时 会 发 生 什么 ? 
Provider 服务 会 发 生 大 量 的 请 求 积 压 ， 而 单个 请 求 的 响应 时 间 会 变 慢 ， 其 他 依赖 Provider 的 
服务 会 等 待 返回 数据 ， 所 以 请 求 积压 响 应 也 开始 变 慢 。 这 种 情况 持续 一 段 时 间 整 个 系统 可 能 就 


Hystrix 为 了 防止 以 上 问题 做 了 很 多 努力 ， 它 采用 线程 或 者 信号 量 隔离 、 近 乎 实时 的 监控 业 


E 请 求 时 配置 


判 ， 从 而 使 服务 济 


、 快 速 失 败 及 默认 失败 返回 等 方法 使 整个 集群 不 至 于 由 于 一 点 故 
PvE PS. PIU Provider 服务 出 现 了 业务 积压 ， 那 么 其 他 j 
情况 ， 如 果 消 费 者 服务 如 
MAR) Hystrix BEM BME, w3 


由 用 服务 就 会 出 现 请 求 超时 的 
了 Hystrix, Hystrix 会 监控 此 请 求 在 一 定时 间 内 失败 次 数 
果 达 到 就 会 触发 Hystrix HRERL 


H, 
Fe 


j 费 者 停止 请 


求 Provider 服务 ， 这 样 Provider 就 有 机 会 在 非 正常 情况 下 恢复 过 来 ， 保 证 一 定 的 业务 承载 能 


力 ， 而 不 至 于 | 


它 一 点 而 导致 整个 集群 的 竣 痪 。 


当然 ， 整 个 系统 不 会 由 于 配置 了 Hystrix 而 保证 所 有 请 求 都 了 


E 常 ， 所 有 请 求 都 


各 节点 具备 相应 的 承载 能 力 。Hystrix 在 上 一 情况 中 ， 仅 会 保证 集群 不 会 


ul 


执行 的 方法 即 可 ， 下 面 在 Service 实现 类 的 getUserFromProvider 方法 中 添 


证 部 分 的 业务 承载 。 


本 小 节 会 介绍 Hystrix 


(1) 添加 依赖 
在 Consumer 工程 中 ， 添 力 


<dependency> 


的 使 用 方法 ， 包 含 部 分 Hystrix 的 配置 及 作用 ， 
HystrixDashboard 监控 页 面 以 及 Turbine 聚合 监控 。 


9.3.1 Hystrix 基本 使 用 


0 Hystrix 的 组 件 依 赖 。 


<groupId>org.Springframework.cloud</groupId> 
<artifactld>spring-cloud-starter-hystrix</artifactld> 


</dependency> 
(2) 添加 局 动 类 注解 


在 启动 类 中 ， 添 加 注解 @EnableHystrix。 


(3) 添加 Hystrix 快速 失败 逻辑 


Hystrix 的 快速 失败 只 要 寿 


@Override 


FE 方法 上 添加 一 个 @HystrixCommand， 


@HystrixCommand(fallbackMethod="getUserFallback") 
public DomainUser getUserFromProvider(int id) { 
Result<DomainUser> result = feign.getUser(id); 
if(result.getResultCode)=200) { 
return (DomainUser)result.getData(); 


yelse { 
return null; 
} 
} 


public DomainUser getUserFallback(int id) { 


加 失败 逻辑 。 
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DomainUser user = new DomainUser(); 
user.setName("hystrix"); 

user.setA ge(-1); 
user.setAddress("hystrix fall back"); 
return user; 


} 
(4) 效果 演示 
在 Provider 服务 启动 的 情况 下 ， 调 用 Consumer 服务 的 get 接口 http://47.95.113.117:18020/ 
consumer/7 可 以 得 到 如 下 输出 : 
{"resultCode":200,"mse":"ok","data": {"id":7,"address":" HEBR" "age":18,"name":"svn","phoneNum": "12345678901"}}。 


关闭 Provider 服务 后 ， 再 次 调用 此 接口 ， 输 出 为 9 
{"resultCode":200,"msg":"ok","data":{"id":null,"address":"hystrix fall back","age":-1,"name":"hystrix", 
"phoneNum":null}} 
可 见 ， 当 服务 提供 者 不 可 用 时 ， 服 务 消费 者 中 配置 了 Hystrix 的 方法 可 以 快速 失败 并 且 返 回 
fallback 方法 默认 的 数据 。 
(5) 添加 可 视 化 页 面 依赖 
添加 Hystrix 的 可 视 化 监控 页 面 ， 需 要 添加 如 下 依赖 : 
<dependency> 
<groupld>org.springframework.cloud</groupId> 
<artifactld> 
spring—cloud-starter—-hystrix—dashboard 


</artifactld> 
</dependency> 


(6) 添加 启动 类 注解 

添加 可 视 化 页 面 的 局 动 类 注解 @EnableHystrixDashboard。 

(7) 查看 页 面 

要 查看 Hystrix 的 监控 页 面 ， 只 需要 在 服务 的 IP 和 端口 后 添加 hystrix 路 径 即 可 。 例 如 此 服 
务 的 Hystrix 页 面 访问 路 径 是 47.95.113.117:18020/hystrix， 如 图 9-8 所 示 。 


Œ | © 47.95.113.117:18020/hystrix tje 


Co 


Hystrix Dashboard 
ip hostname portturbine/urbine sream 
Cluster via Turbine (default cluster): http://turbine-hostname:port/turbine.stream, 
Cluster via Turbine (custom cluster): http://turbine-hostname:port/turbine.stream?cluster=[clusterName] 
Single Hystrix App: http://hystrix-app:port/hystrix.stream 


Delay: [2000 ms Title: [Example Hystrix App 


Monitor Steam 


图 9-8 Hystrix 页 面 


O 这 里 仅 为 了 演示 ， 所 以 没有 修改 返回 的 错误 码 。 实 际 业务 中 ， 应 根据 希望 达到 的 效果 正确 使 用 fallback。 
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在 地 址 栏 中 输入 http:/127.0.0.1:18020/hystrix.stream92，Delay 默 认 使 用 2000, Title 输入 框 输 


入 Consumer， 然 后 点 击 Monitor Stream， 可 以 看 到 如 图 9-9 所 示 页 面 。 


M 
Hystrix Stream: Consumer HYSTRIX 

AS DEFEND YOUR APP 
Circuit Sort: Error then Volume | Alphabetical | Volume | Error | Mean | Median | 90 | 99 | 99.5 Success | Short-Circuited | 1 | Rejected | Failure | Error % 


(8) 页 面 中 数据 的 含义 


ConsumerServicelmpl 
0.0/s 
ster: 0.0/s 


= 
a 


图 9-9 Hystrix 监控 


这 个 页 面 就 是 Hystrix 用 于 监控 展示 的 页 面 ， 页 面 分 为 两 部 分 ， 上 面 为 被 监控 方法 的 展示 ， 
下 面 为 线程 监控 展示 。 


重新 启动 Provider 服务 ， 然 后 对 Consumer 服务 的 这 个 接口 进行 一 定 的 访问 ， 观 察 页 面 变 
化 。 如 图 9-10 所 示 。 
图 中 的 上 半 部 分 最 明显 的 两 个 


而 


形 元 素 是 实心 加 和 变化 曲线 。 


E 实心 圆 会 随 着 业务 访问 的 压力 情况 变化 ， 流 量 越 大 实心 圆 就 越 大 。 同 时 实心 圆 的 颜色 会 
表示 这 个 方法 的 健康 状态 ， 绿 色 为 最 好 ， 红 色 为 最 差 。 


pA 


变化 


9-11 所 示 。 


| 线 表 示 流 量 的 相对 变化 。 


图 中 上 半 部 分 的 数字 ， 当 移动 鼠标 到 上 面 的 时 候 会 有 相应 的 提示 ， 各 个 监控 数据 含义 如 图 


/9 


Hystrix Stream: Consumer 


Circuit Sort: Error then Volume | Alphabetical | 


getUserFromProvider 
1 


- 0.0 成 功 数 “0 超时 数 
> wie rau O | 0 。 线程 池 拒绝 数 
| 坏 请 求 数 0 。 失败 数 
| 1.1/s 
1.1/s 
Circuit Closed 
Hosts 1 90th 975 getUserFromProvider : . 
Median 791ms 。 99th 975ms — 0|0|0.0 最 近 10 秒 错误 比例 
Mean 595ms 99 5th 975ms 0|0 
Thread Pools Sort: Alphabetical | Volume | 0 
ConsumerServicelmpl lost: 0.1/s ay, 
st: 1.1/s ster: 0.1/8 一 段 时 间 的 请 求 频率 
a ia Circuit Closed 。 ”断路 器 状态 
Active Viax Active 
a Eac 5 Hosts 1 90th 15ms "i E 
Bd 20). Peano.. M Median tims 99th 15ms ” 百 分 位 耗 时 统计 
Mean 11ms 99.5th 15ms 
图 9-10 Consumer 服务 监控 信息 图 9-11 Hystrix 监控 数据 含义 


y 


图 


P 下 半 部 分 的 数据 Thread Pools 是 线程 监控 的 情况 。 后 面 会 介绍 线程 数量 的 设置 ， 也 就 


O 如 果 感 兴趣 ， 可 以 直接 访问 http:// ip:18020/hystrix.stream 地 址 ， 观 察 页 面 的 原始 数据 。 男 外 注意 服务 的 地 址 ， 
务 已 经 部 署 到 外 网 上 ， 所 以 前 面 页 面 请 求 的 地 址 是 一 个 外 网 地 址 ， 但 是 此 处 输入 的 是 127.0.0.1， 是 由 于 此 服务 是 自我 数据 的 访问 ， 所 以 


于 演示 工程 的 服 


输入 自己 的 本 机 地 址 即 可 。 但 是 如 果 想 用 浏览 器 访问 外 网 的 hystrix.stream， 还 是 应 该 使 用 外 网 地 址 。 
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是 图 中 的 Pool Size 以 及 线程 的 定义 等 。 


9.3.2 Feign 与 Hystrix 结合 


Feign 是 自 带 断路 器 的 ， 但 是 需要 在 配置 文件 中 打开 Feign 的 断路 器 开关 。 打 开 开关 后 ， 只 要 在 
Feign 接口 类 的 注解 @FeignClient 中 添加 fallback 设置 ， 就 可 以 实现 快速 失败 返回 。 
(1) 打开 断路 器 开关 
在 yml 文件 中 添加 如 下 配置 ， 即 可 打开 Feign 的 断路 器 开关 。 

feign: 

hystrix: 
enabled: true 
(2) 配置 Feign 的 fallback 
在 Feign 的 接口 类 上 方 @FeignClient 中 ， 配 置 fallback 属性 ， 属 性 指向 一 个 负责 处 理 快速 失 
败 的 类 。 这 个 处 理 快速 失败 的 类 继承 Feign 接口 类 ， 所 以 类 中 的 方法 和 Feign 保持 相同 ， 用 于 实 
现 对 应 的 Feign 接口 类 中 方法 的 快速 返回 。 


@FeignClient(value="SERVICE-PROVIDER", fallback=ConsumerFeignFallBack.class) 
public interface ConsumerFeign { 

@RequestMapping(value="/user/ {id}",method=RequestMethod.GET) 

public Result<DomainUser> getUser(@RequestParam("id") int id); 


t 


paf 


i 


= 


@RequestMapping(value="/user/add",method=RequestMethod.POST) 
public Result<String> addUser(@RequestBody DomainUser user); 


} 
@Component 
public class ConsumerFeignFallBack implements ConsumerFeign { 
@Override 
public Result<DomainUser> getUser(int id) { 
Result<DomainUser> result = new Result<>(ResultCode. Unavailable); 
return result; 
} 
@Override 
public Result<String> addUser(DomainUser user) { 
Result<String> result = new Result<>(ResultCode.Unavailable); 
return result; 
} 
} 


Fee 可 以 在 Feign 调用 时 就 实现 断路 器 逻辑 ， 而 且 这 种 写法 要 比 对 单个 方法 
实现 fallback 简洁 得 多 。 

aC ) 监控 页 面 展示 

查看 监控 页 面 ， 如 图 9-12 所 示 。 发 现 除了 在 上 一 小 节 添 加 的 getUserFromProvider 方法 被 监 

控 以 外 ，Feign 中 的 getUser 方法 也 受到 了 监控 。 但 Feign 中 的 addUser 方法 没有 受到 监控 ， 因 为 

还 没有 调用 此 方法 ， 没 有 相关 的 监控 数据 ， 所 以 监控 页 面 没 有 显示 。 在 监控 页 面 的 下 方 ， 会 发 

现 又 出 现 了 一 个 线程 池 ， 线 程 池 的 名 字 默 认 使 用 所 在 类 名 或 者 Feign 的 注解 中 的 名 字 。 
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Hystrix Stream: Consumer 


Circuit Sort: Error then Volume | Alphabetical | Volume | Error | Mean | Median | 90 | 99 | 99.5 


getUserFromProvider ConsumerFeign#getUser(int) 
> 8 0.0 +: 8 0.0% 
0|0 ojoj 
| 0 | 0 
J H 0.8/s 
us ster: 0.8/s 
Circu Circuit Closed 


Hosts 1 = 90th 
Median Oms 99th 
Mean Oms 995th 


Thread Pools Sort: Alphabetical | Volume | 


Hosts 1 90th Oms 
Median Oms 99th Oms 
Mean Oms 995th Oms 


SERVICE-PROVIDER Consumer Servicelmpl 

Host: 0.6/s Host: 0.6/s 

uster: 0.6/s s 0.6/s 

Active 0 Max Active 1 Active 0 Max Active 1 
Queued 0 Executions 6 Queued 0 Executions 6 
Pool Size 8 Queue Size 5 Pool Size 8 Queue Size 5 


图 9-12 Hystrix 监控 


(4) 接口 压力 测试 
下 面 对 获 取信 息 接 口 进行 压力 测试 ， 观 察 其 业务 承载 能 力 和 监控 数据 的 变化 2， 如 网 9-13 
所 示 。 


Circuit Sort: Error then Volume | Alphabetical | Volume | Error | Mean | Median | 90 | 99 | 99.5 


getUserFromProvider ConsumerFeign#getUser(int) 
187 70.0 % 187 0.0 
5,062 | 444 n ojo 
0 0 
J 


st: 63.1/s f 


63.1/s 
Circuit Open 
Hosts 1 90th 41ms Hosts 1 
Median 14ms 99th 101ms Median tims 99th 9 
Mean 20ms 99.5th 105ms Mean 17ms 995th 105ms 
Thread Pools Sort: Alphabetical | Volume | 

SERVICE-PROVIDER ConsumerServicelmp! 
st: 18.7/s st: 18.7/s 
18.7/s Cluster: 18.7/s 
Active 0 Max Active 10 Active 0 Max Active 10 
Queued 0 Executions 187 Queued 0 Executions 187 
Pool Size 10 Queue Size 5 PoolSize 10 Queue Size 5 


图 9-13 服务 压力 监控 

可 见 当 程序 压力 较 大 时 ， 大 部 分 的 请 求 都 被 熔断 和 线程 拒绝 了 ， 这 不 是 希望 得 到 的 结果 。 
熔 断 的 添加 是 保证 程序 达到 上 限 后 不 会 集体 瘫痪 ， 而 不 是 限制 程序 的 执行 能 力 。 所 以 需要 了 解 
Hystrix 的 一 些 配置 。 


9.3.3 Hystrix 相关 配置 


Hystrix 的 配置 比较 多 ， 包 含 设 定 熔 断 规则 、 能 力 开启 、 选 择 隔 离 方式 以 及 线程 数 、 并 发 数 
等 设置 ， 下 面 了 解 一 些 常用 的 Hystrix 配置 项 。 
(1) 线程 数 配 置 
在 配置 文件 中 ， 添 加 如 下 配置 ， 然 后 再 次 对 服务 进行 压力 测试 ， 如 图 9-14 所 示 。 
hystrix: 
threadpool: 


default: 
coreSize: 100 


x 


O 这 里 为 了 演示 的 连贯 性 ， 没 有 删除 getUserFromProvider 方法 的 熔断 器 代码 ， 但 是 此 方法 和 Feign 接口 类 监控 的 是 同一 个 调用 ， 
所 以 在 实际 工作 中 应 该 避免 这 种 浪费 性 能 的 重复 。 
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a 


Circuit Sort: Error then Volume | Alphabetical | Volume | Error | Mean | Median | 90 | 99 | 99.5 


ar He 
= a | 1.0 % 

0 o| 
| Host: 178.1/s Host: 188.9/s 
r: 178.1/s Cluster: 188.9/s 
Circuit Closed Circuit Closed 
Hosts 1 90th 836ms Hosts 1 90th 731ms 
Median 117ms 99th 1165ms Median 74ms 99th 1122ms 
Mean 259ms 99 5th 1245ms Mean 231ms 99 5th 1236ms 

Thread Pools Sort: Alphabetical | Volume | 

SERVICE-PROVIDER ConsumerServicelmpl 
Host: 180.6/s dost: 180.9/s 
er: 180.6/s ster: 180.9/s 
Active 94 Max Active 100 Active 90 Max Active 100 
Queued 0 Executions 1,806 Queued 0 Executions 1,809 
Pool Size 100 Queue Size 5 Pool Size 100 Queue Size 5 


图 9-14 ”服务 压力 监控 
去 结果 可 抑 ， 服 务 现 在 基本 处 于 稳定 运行 的 状态 ， 仅 者 几 不 调用 是 超时 的 还 


有 一 点 应 该 注意 ， 在 Thread Pools 部 分 ，Pool Size 从 10 变 成 了 100。 可 见 使 用 配置 扩大 线程 数 


(2) 设置 超 


后 ， 人 TS 


时 时 间 


上 图 中 存在 


一 些 请 求 的 超时 情况 ， 如 果 被 调用 服务 的 业务 逻辑 比较 复杂 ， 或 者 压力 较 大 时 


执行 速度 较 慢 ， 但 又 不 希望 Hystrix 很 快 就 判定 服务 调用 超时 ， 这 时 可 设置 一 个 期 望 的 值 ， 作 为 
炊 断 器 判定 超时 的 依据 。 


hystrix: 


command: 
default: 
execution: 


isolation: 
thread: 
timeoutInMilliseconds: 2000 


通过 配置 把 超时 时 间 设 置 为 2s， 服务 再 次 执行 压力 测试 ， 没 有 出 现 超时 情况 ， 整 个 服务 运行 正 
常 ， 如 图 9-15 所 示 。 注 意 超时 时 间 不 要 设置 过 大 ， 如 果 设 置 为 几 十 秒 就 失去 了 意义 


Hystrix Stream: Consumer 


Circuit Sort: Error then Volume | Alphabetical | Volume | Error | Mean | Median | 90 | 99 | 99.5 


ConsumerFeign#getUser(int) getUserFromProvider 
310 | 010.0 9 3,247 | 0).0.0 

0/0 上 0|0 

0/0 0/0 
=< y Host: 332.4/s = Host: 330.1/s 
Cluster: 332.4/s Cluster: 330.1/s 
Circuit Closed Circuit Closed 
Hosts 1 90th 446ms Hosts 1 90th 478ms 
Median 97ms 99th 796ms Median 115ms 99th 1083ms 
Mean 168ms 995th 863ms Mean 192ms 99 5th 1136ms 

Thread Pools Sort: Alphabetical | Volume | 


ConsumerServicelmpl SERVICE-PROVIDER 


iost: 337.1/s dost: 337.1/s 
er: 337.1/s 337.1/s 


oono “4 M ay 100 Active “lf Maj A 100 
3,371 Queued 3,371 
Pool ‘See 100 Queue SE 5 Pool Size 100 Queue Size 5 


© 在 实际 项 目 中 ， 不 要 盲目 扩大 线程 数 ， 线 程 数 的 配置 要 和 服务 器 每 秒 承载 的 请 求 数 、 单 个 请 求 的 执行 时 间 、 服 务 器 的 资源 情况 


等 因素 良好 地 配合 。 
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(3) 信号 量 隔离 与 并 发 数 
另 一 种 隔离 方式 是 信号 量 隔离 ， 它 没有 单独 
使 用 信和 号 量 隔离 也 能 承载 相当 的 业务 压力 
9-16 所 示 。 
hystrix: 
command: 
default: 
execution: 
isolation: 
strategy: SEMAPHORE 
semaphore: 
maxConcurrentRequests: 2000 
thread: 
timeoutInMilliseconds: 2000 


t 


辟 出 一 个 线程 池 ， 而 是 
， 只 是 它 没有 线程 池 监 控 5， 


] 并 发 数 进行 控制 。 
具体 配置 如 下 。 效 果 如 


而 


Hystrix Stream: Consumer 


Circuit Sort: Error then Volume | Alphabetical | Volume | Error | Mean | Median | 90 | 99 | 99.5 
ConsumerFeign#getUser(int) getUserFromProvider 
3,559 | 0 | 0 3,601 | 0 | 0 
0 mA 0/0 


/ 
fi Host: 359.2/s 
Cluster: 359.2/s 


| Host: 361.0/s 
Cluster: 361.0/s 


Circuit Closed Circuit Close 
Hosts 1 90th 374ms Hosts 1 90th 389ms 
Median 74ms 99th 757ms Median 79ms 99th 774ms 
Mean 141ms 995th 832ms Mean 147ms 99 5th 843ms 


Thread Pools 


Sort: Alphabetical | Volume | 


图 


C4) SDT Hh ACU BK 


可 以 设置 熔断 执行 的 条 件 ， 例 如 下 面 的 设 定 ， 是 设置 


触发 熔断 机 制 ， 默 认为 20， 这 里 设 定 为 


hystrix: 
command: 
default: 
circuitBreaker: 
request VolumeThreshold: 1 


9-16 ”服务 压力 监控 


当 滚 动 时 间 窗 口内 ， 达 到 几 次 失败 则 


1， 此 设置 仅 作 为 演示 ， 毕 竞 这 个 值 实在 是 太 小 了 。 


Hystrix 还 有 一 些 其 他 设置 ， 例 如 设置 线程 池 的 队列 大 小 ， 设 置 深 动 时 间 窗 口 的 长 度 等 ， 如 


果 没 有 特殊 需求 ， 使 
9.3.4 Hystrix 作为 限 流 工具 


上 一 小 节 中 ， 把 断路 器 添加 在 了 Consumer 服务 的 Feign 调 月 


] 默 认 值 即 可 。 当 然 如 果 对 划 


Jag ne 


way ZN 


非常 


可 以 翻阅 相关 文档 。 


中。 如 果 在 一 个 大 的 集群 中 ， 


有 很 多 个 业务 月 


会 在 Provider 


有 务 需 要 调 朋 


H Provider 服务 的 接口 ， 而 这 些 服 务 中 有 的 没有 添加 炊 断 逻辑 ， 那 么 


服务 达到 性 能 上 限时 被 拖 震 。 是 否 可 以 在 Provider 服务 的 接口 本 身 做 流量 限制 和 


O 本 处 演示 完 后 ， 会 删除 getUserFromProvider 方法 的 熔断 器 配置 。 
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快速 失败 呢 ? O 
按照 之 前 的 介绍 ， 对 Provider 服务 先 完成 Hystrix 的 依赖 引入 和 启动 类 、 配 置 文件 配置 。 之 
后 修改 Controller 的 代码 如 下 : 


@HystrixCommand(commandK ey="provider-getuser",groupKey="provider-usercontroller", 
fallbackMethod= "getUserFallBack") 
@RequestMapping(value="/ {Id}",method=RequestMethod.GET) 
public Result<DomainUser> getUser(@PathVariable("Id") int id) { 
DomainUser user = service.getUser(id); 
Result<DomainUser> result = null; 
if(user!=null) { 
result = new Result<>(ResultCode.OK, user); 
yelse { 
result = new Result<>(ResultCode.Not_Found); 


} 


return result; 


j 


public Result<DomainUser> getUserFallBack(int id) { 
Result<DomainUser> result = new Result<>(ResultCode.Unavailable); 
return result; 


} 
代码 中 对 接口 添加 了 熔断 ， 并 且 用 commandKey 配置 了 方法 在 监控 页 面 的 显示 名 称 ; 用 
groupKey 配置 了 线程 池 名 字 ， 同 一 groupKey 的 方法 使 用 同一 线程 池 ; 配置 了 一 个 快速 失败 的 数 
据 结果 返回 ， 返 回 错误 码 503. 
下 面 打开 此 服务 的 监控 页 面 ， 观 察 其 监控 显示 ， 如 图 9-17 所 示 。 


Hystrix Stream: provider 


Circuit Sort: Error then Volume | Alphabetical | 


provider-getuser 
2,443 


人 0/0 
pn F 0/0 
f | 
| \ f Host221.3/s 
Cluster: 221.3/s 


Circuit Closed 

Hosts 1 90th 8ms 
Median 6ms 99th 77ms 
Mean 7ms 995th 101ms 


Thread Pools Sort: Alphabetical | Volume | 


provider-usercontroller 


242.8/s 

242.8/s 

Active 1 Max Active 56 
Queued 0 Exec 2,428 
Pool Size 100 Queue Size 5 


图 9-17 服务 压力 监控 


O 这 里 作者 翻阅 了 较 多 的 资料 ， 大 部 分 资料 是 介绍 Hystrix 原理 和 使 用 方法 的 ， 但 是 使 用 在 何 处 却 论述 较 少 。 通 常 的 用 法 是 在 服 
务 调用 时 使 用 ， 但 是 作者 认为 在 Controller 的 接口 上 使 用 Hystrix 限 流 也 是 个 不 错 的 办 法 。 这 样 可 以 在 调用 之 初 就 避免 接口 向 后 的 服务 压 
力 。 毕 况 Hystrix 要 避免 程序 执行 过 程 中 的 故障 ， 程 序 调用 的 源头 也 是 属于 执行 流程 之 内 的 。 
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+} 


生 对 后 面 的 聚合 监控 比较 有 好 


H 


可 见 ， 代 码 中 设置 的 方法 名 和 线程 组 已 经 生效 ， 设 置 这 些 
处 ， 用 户 可 以 更 加 方便 地 看 到 某 个 服务 的 运行 情况 。 


9.3.5 Turbine REJER 


Turbine 是 HystrixDashboard 的 聚合 展示 ， 它 可 以 通过 配置 ， 实 现 多 个 服务 的 监控 以 及 同一 服务 
多 台 实 例 的 聚合 报告 。 下 面 使 用 Turbine 监控 Provider 服务 和 Consumer 服务 的 运行 情况 。 
C1) 创建 工程 
新 建 一 个 工程 ， 工 程 名 为 SpringCloudTurbine， 其 他 配置 遵循 前 面 介绍 的 Spring Boot 工程 
的 配置 方法 即 可 。 
(2) 添加 依赖 
由 于 Turbine 需要 监控 各 个 服务 ， 所 以 它 需 要 连接 到 Eureka 上 ， 同 时 还 要 引入 Turbine 的 功 
能 组 件 ， 为 了 有 显示 页 面 ， 还 要 有 hystrix-dashboard 依赖 。 


<dependency> 
<groupld>org.springframework.cloud</groupId> 
<artifactld>spring-cloud-starter-eureka</artifactld> 

</dependency> 

<dependency> 
<groupld>org.springframework.cloud</groupId> 
<artifactId>spring-cloud-starter-turbine</artifactld> 

</dependency> 

<dependency> 
<groupld>org.springframework.cloud</groupId> 
<artifactld> 

spring—cloud-starter-hystrix—dashboard 

</artifactld> 

</dependency> 


(3) 局 动 类 添加 注解 
在 启动 类 中 开启 Eureka, HystrixDashborad 和 Turbine. 


@EnableEurekaClient 

@EnableTurbine 

@EnableHystrixDashboard 
(4) 服务 监控 分 组 
在 Consumer 和 Provider 服务 的 配置 文件 中 ，eureka.instance 路 径 下 ， 添 加 matadata- 
map.cluster 配置 ， 把 应 用 服务 加 入 一 个 监控 组 ， 有 具体 如 下 : 


eureka: 
instance: 
metadata—map: 
cluster: main 


(5) Turbine 配置 


server: 
port: 18030 

spring: 
application: 
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name: turbine 


eureka: 
instance: 
hostname: turbine 
prefer-ip-address: true 


instance-id: ${spring.cloud.client.ipAddress}:$ {server.port} 
client: 


region: javadevmap 
availability—zones: 

javadevmap: map_eureka 
service-url: 


map_ eureka: http://172.17.238.237:18001/eureka/,http://172.17.238.239:18001/eureka/ 
turbine: 


app-config: SERVICE-CONSUMER,SERVICE-PROVIDER 
aggregator: 

clusterConfig: main 
clusterNameExpression: metadata|['cluster’] 
combine-host-port: true 


在 Turbine 服务 中 ， 除 了 配置 常规 的 端口 、 名 字 ， 还 要 配置 Eureka 和 Turbine 特有 的 配置 。 
中 turbine.app-config 配置 要 监控 的 服务 名 ; turbine.aggregator.clusterConfig 配置 可 选 分 组 ; 
turbine.clusterNameExpression 会 根据 页 面 参 数 传 入 的 分 组 进行 不 同 的 分 组 监控 ，turbine.combine- 
host-port 为 true 表示 根据 host 和 port 进行 实例 区 分 。 

(6) 页 面 展示 


打开 turbine 服务 部 署 地 址 的 Hystrix Dashboard 页 面 ， 即 47.95.113.117:18030/hystrix; 在 
面 中 输入 turbine 数据 流 地 址 和 监控 的 分 组 ， 如 图 9-18 所 示 。 


> GG | O FRE | 47.95.113.117 


页 


~ 


Nl 


N 


Gi 


= 
Ly 


Hystrix Dashboard 


http://127.0.0.1:18030/turbine.stream?cluster=main 


Cluster via Turbine (default cluster): http://turbine-hostname:port/turbine.stream 
Cluster via Turbine (custom cluster): http://turbine-hostname:port/turbine.stream?cluster=[clusterName] 
Single Hystrix App: http://hystrix-app:port/hystrix.stream 
Delay: |200 ms Title: turbine 


Monitor Stream 


K| 9-18 Turbine 配置 


由 于 使 用 浏览 器 打开 的 是 Turbine 服务 自己 的 链接 地 址 ， 所 以 在 输入 数据 流 时 ， 使 用 的 是 本 
机 的 IP 地 址 ， 并 且 设 定 分 组 为 main， 输 入 框 具体 输入 的 地 址 为 http://127.0.0.1:18030/turbine. 
stream?cluster=main， 进 入 后 可 以 看 到 监控 页 面 ， 如 图 9-19 所 示 。 

220 


a 


第 9 章 Spring Cloud 


ili 
Hystrix Stream: turbine HYSTRIX 
“ DEFEND YOUR APP 
Circuit Sort: Error then Volume | Alphabetical | Volume | Error | Mean | Median | 90 | 99 | 99.5 
Success | Short-Circuited | Rejected | Failure | Error % 
ConsumerFeign#getUser(int) provider-getuser 
0/0 0|0 


Hosts 
Median 668ms 
Mean 668ms 99.5t 


Thread Pools 


Sort: Alphabetical | Volume | 


SERVICE-PROVIDER provider-usercontroller 


民 y 
可 见 ， 两 个 服务 的 监控 数据 已 经 聚合 ， 并 且 由 于 provider 启动 的 是 两 个 实例 ， 所 以 在 及 


图 9-19 J 


Ds 
gay 


provider-getuser 接口 显示 的 Hosts 数 为 2。 


(7) 多 分 组 监控 


Turbine 的 多 分 组 设置 相对 简单 ， 只 要 在 被 监控 的 不 同 实例 中 配置 不 同 的 分 组 名 ， 然 后 在 


Turbine 服务 的 clusterConfig 配置 项 中 配置 要 监控 的 分 组 列表 ， 中 间 通 过 逗号 隔 开 ; 在 


Dashboard 页 面 中 ， 用 cluster 选择 不 同 的 分 组 即 可 。 


9.3.6 Turbine 通过 总 线 聚 合 信息 


Turbine 可 以 通过 六 


Ñ. 


昌 总 线 搜 集 服务 的 监控 信息 ， 也 就 是 说 被 监控 服务 器 的 数据 不 是 直接 到 


达 Turbine 服务 ， 而 是 发 送 到 一 个 消息 队列 ， 然 后 Turbine 服务 从 消息 队列 ?中 获取 监控 数据 。 


(1) Turbine 服务 依赖 


Turbine 服务 依赖 需要 更 换 ， 不 再 使 用 之 前 的 Turbine 依赖 ， 而 使 用 Turbine-amqp 依赖 


组 件 。 


<dependency> 


<groupId>org.Springframework.cloud</groupId> 
<artifactId>spring-cloud-starter-turbine-amqp</artifactId> 


</dependency> 
(2) 启动 项 配置 


spring: 
rabbitmq: 


更 换 启 动 项 为 @EnableTurbineStream。 
(3) 添加 消息 队列 地 址 
配置 rabbitmg 的 地 址 及 账号 。 


host: 172.17.238.238 


port: 5673 


username: guest 
password: guest 


O 这 里 消息 队列 使 用 RabbitMQ， 后 面 的 章节 会 包含 一 个 简单 的 RabbitMQ 的 安装 方法 ， 这 里 就 不 再 介绍 其 安装 。 
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通过 以 上 这 几 步 ，Turbine 服务 完成 了 新 的 配置 。 
(4) 被 监控 服务 依赖 
对 于 需要 监控 的 服务 ， 添 加 如 下 依赖 组 件 ， 
<dependency> 
<groupld>org.springframework.cloud</groupId> 
<artifactlId>spring-cloud-netflix—hystrix—amgp</artifactld> 
</dependency> 


(5) 被 监控 服务 添加 消息 队列 地 址 


Spring: 
rabbitmq: 
host: 172.17.238.238 
port: 5673 
username: guest 
password: guest 


(6) RabbitMQ 队列 情况 
观察 消息 队列 的 通道 和 队列 情况 ， 如 图 9-20. K 9-21 所 示 ， 发 现 以 上 程序 正在 通过 消息 
队列 进行 监控 数据 的 传输 。 
出 Rabbit 


Overview Connections Exchanges Queues Admin 


Yy 


I 


上 


使 其 能 够 把 监控 信息 发 送 至 消息 队列 。 


À 


Channels 


All channels (7) 


Pagination 
Page| 1 v| of 1 - Filter: Regex (?)( 
Overview Details Message rates 
Channel User name Mode State Unconfirmed Prefetch Unacked publish confirm deliver / get ack 

172.18.0.1:45482 (1) guest idle 0 0 

172.18.0.1:45526 (1) guest idle 0 0 

172.18.0.1:46122 (1) guest idle 0 0 

172.18.0.1:46178 (1) guest running 0 0 4.0/s 0.00/s 

172.18.0.1:46198 (1) guest running 0 0 4.0/s 0.00/s 

172.18.0.1:46256 (1) guest running 0 0 4.0/s ”0.00/s 

172.18.0.1:46624 (1) guest running 0 1 1 12/s 12/s 

TTP API| Command Li 

图 9-20 RabbitMQ 页 面 (一 ) 
出 R | bit User: guest Log out 
aoolt Cluster: rabbit@249efa8ad33b (change) 一 
RabbitMQ 3.6.12, Ẹrlang 19.2.1 

Overview Connections Channels Exchanges Queues Admin 


Queues 


All queues (1) 


Pagination 
Page [1 v| of 1 - Filter: Regex Displaying 1 item , page size up to: 
Overview Messages Message rates 
Name Features State Ready Unacked Total incoming deliver / get ack 
springCloudHystrixStream.anonymous.u7yb2Fx_RPW-QNtOJDKOLg AD Excl running 0 0 0 12/s 12/s 12/s 
Add a new queue 
TTP API | Command Li Update | every 5 seconds Y 


ast update: 2018-04-13 23:48:48 


图 9-21 RabbitMQ 页 面 =>) 
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(7) 监控 页 面 展示 
打开 Consumer 服务 的 Hystrix 页 面 ， 输 入 Turbine Stream 的 地 址 ， 可 以 看 到 如 图 9-22 所 示 


Fe PK 
监控 数据 。 
Hystrix Stream: turbine 
Circuit Sort: Error then Volume | Alphabetical | Volume | Error | Mean | Median | 90 | 99 | 99.5 
serv...der.provider-getuser serv...erFeign#getUser(int) 
0/0 ojoj 
0 0 
provider-usercontroller SERVICE-PROVIDER 
0.0/s 0.0/s 
0.0/s 0.0/s 
Activ 0 0 Acti 0 M tive 0 
Queued 0 0 Queued 0 0 
00| Size 7 2 Pool Si; 6 5 
图 9-22 服务 监控 页 面 
9.4 Zuul 


一 个 前 端 发 起 的 Web 请 求 ， 如 果 是 通过 域名 访问 的 ， 那 么 首先 会 进行 DNS 解析 ， 解 析出 


来 的 是 一 个 或 者 几 个 IP 地址， 这 个 P 地 址 一 般 是 反 向 代理 和 负载 的 地 址 。 负 载 会 把 请 求 转 到 微 
服务 集群 中 进行 业务 逻辑 的 处 理 。 如 果 服 务 集 群 中 存在 多 个 服务 并 且 每 个 服务 存在 多 个 实例 ， 
那么 负载 要 根据 请 求 路 径 进行 服务 区 分 ， 并 且 对 这 一 服务 的 多 个 实例 地 址 进行 负载 策略 ， 这 样 


对 于 负载 来 讲 工作 量 就 有 些 大 了 ， 而 且 把 这 个 规则 配置 到 负载 上 ， 当 多 个 服务 的 多 个 实例 出 现 
变化 时 ， 负 载 的 配置 工作 量 很 大 ， 所 以 微服 务 集 群 需要 一 个 统一 的 入 口 ， 这 就 是 Zuul。 
Zuul 的 能 力 不 仅 仅 是 服务 路 由 的 能 力 ， 还 可 以 在 Zuul 中 对 请 求 进行 统一 的 身份 认证 、 参 数 


校 验 等 其 他 逻辑 。 


下 面 逐 一 介绍 Zuul 的 这 些 常用 方法 。 


9.4.1 Zuul 的 基本 使 用 
Zuul 服务 也 是 一 个 Spring Boot 工程 ， 通 过 引入 不 同 的 依赖 和 配置 ， 实 现 不 同 的 能 力 。 首 先 


创建 一 个 SpringC 


loudZuul 工程 ， 在 工程 中 进行 如 下 配置 。 


C1) 添加 依赖 


于 本 例 使 月 


H Zuul 根据 服务 名 进行 路 由 2?， 所 以 需要 添加 Eureka Client 的 服务 发 现 依赖 ， 


同时 需要 添加 Zuul 的 组 件 依赖 。 


<dependency> 
<groupId>org.Springframework.cloud</groupId> 
<artifactlId>spring-cloud-starter-eureka</artifactld> 

</dependency> 

<dependency> 


对 于 不 针对 服务 ， 仅 对 单独 人 P 端口 的 路 由 ， 可 以 不 配置 Eureka， 仅 配置 接口 路 径 和 地 址 映射 即 可。 具体 格式 后 面 会 有 简单 介绍 。 
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<groupId>org.springframework.cloud</groupId> 
<artifactId>spring-cloud-starter-zuul</artifactId> 
</dependency> 


(2) 局 动 项 配置 


(3) 添加 配置 文件 


UBEL 


server: 
port: 18040 
spring: 
application: 
name: zuul 


eureka: 
instance: 
hostname: zuul 
instance-id: ${spring.cloud.client.ipAddress}:$ {server.port} 
prefer-ip-address: true 
metadata-map: 
cluster: main 
client: 
region: javadevmap 
availability—zones: 
javadevmap: map_eureka 
service-url: 


配置 文件 中 ， 主 要 配置 服务 本 身 端口 、 名 字 和 Eureka 的 相关 内 容 。 


在 启动 类 中 添加 @EnableEurekaClient 和 @EnableZuulProxy 注解 ， 即 完成 启动 类 配 


ni 


map _eureka: http://172.17.238.237:18001/eureka/,http://172.17.238.239:18001/eureka/ 


(4) 服务 调用 路 由 情况 


上 面 已 经 完成 了 整个 Zul 服务 的 最 基本 使 用 的 配置 ， 但 是 没有 
容 ， 全 部 使 用 默认 项 。 即 使 这 样 集群 内 所 有 服务 也 会 被 Zuul 自动 路 


下 面 使 用 Postman 来 访问 此 接口 ， 效 果 如 图 9-23 所 示 。 


as] 

a 
1 
t 


图 9-23 带路 由 的 服务 请 求 
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配置 集群 内 服务 的 相关 内 
， 路 由 的 路 径 是 服务 名 加 


本 身 接口 路 径 。 如 Consumer 服务 的 /consumer/{id} 接 口 被 路 由 为 /service-consumer/consumer/{id}。 
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9.4.2 Zuu 的 配置 


在 上 面 的 例子 中 ，Consumer 和 Provider 都 通过 Zuul 默认 进行 了 路 由 ， 但 服务 路 由 会 有 一 些 
限制 ， 例 如 不 希望 某 些 服务 被 开放 出 去 ， 或 者 希望 对 服务 路 由 时 的 路 径 进 行 手 动 设置 。 下 面 看 
JLF! Zuul 的 配置 。 

C1) 单 实例 路 

Zuul 不 注册 到 Eureka 上 ， 仅 添加 Zuul 依赖 ， 对 请 求 来 的 路 径 进行 服务 分 发 。 

zuul: 
routes: 
consumer: 


path: /consumer/** 

strip-prefix: false 

url: http://localhost:18020/ 

上 面 的 代码 填写 在 ym 文件 中 ， 其 中 zuulroutes 标签 下 用 于 配置 不 同 路 径 的 路 由 规则 ， 

consumer 标签 表示 路 由 配置 段 ， 每 段 都 有 自己 的 名 字 ; path 表示 路 径 ，url 表示 转发 到 的 服务 地 
ik; strip-prefix 比较 特殊 ， 表 示 在 转发 时 不 去 掉 前 级 (本 例 中 如 果 不 把 它 置 为 false, WA 
consumer 服务 收 到 的 请 求 路 径 则 会 缺失 /consumer， 而 仅 剩 后 面 的 路 径 )。 这 段 配置 的 目的 就 是 把 
请 求 路 径 为 /consumer/** 的 请 求 转发 到 http://localhost:18020/ 服 务 上 。 


EC 


ii 


rA 


i 


请 求 路 径 中 通配符 的 规则 见 表 9-1. 
表 9-1 通配符 规则 
通配符 规 w 
人 匹配 任意 单个 字符 ， 例 如 /consumer? 可 匹配 /consumera 
匹配 任意 数量 的 字符 ， 例 如 /consumer# 可 匹配 /consumerabc 
uF 匹配 任意 数量 的 字符 ， 村 多 级 目录 ， 例 如 /consumer#*# 可 匹配 /consumera/b/c 


(2) 根据 服务 名 路 | 


一 般 情况 下 ， 集 群 


内 的 某 一 服务 不 会 仅仅 布置 一 个 实例 ， 导 


P 么 在 多 实例 的 情况 下 ， 使 用 服 


务 名 进行 自 带 负载 的 路 由 策略 是 个 明智 的 选择 。 根 据 服务 名 路 由 只 要 配置 Eureka 并 且 针 对 每 一 
个 服务 在 配置 文件 中 设置 映射 关系 。 
zuul: 
routes: 
consumer: 


path: /consumer/** 

strip-prefix: false 

service-id: SERVICE-CONSUMER 

provider: 

path: /user/** 

strip-prefix: false 

service-id: SERVICE~-PROVIDER 
路 由 规则 时 ， 和 设置 IP 路 由 区 别 不 大 ， 仪 把 url AC ER 


ot 


在 配 


的 service-id 即 可 完成 


民 据 服务 名 路 由 。 例 如 通过 Zuul 访问 Provider 服务 ， 可 以 在 Provider 多 台 实 例 的 日 志 中 看 到 轮 
询 的 日 志 打印 。 
(3) 前 级 的 用 处 


N 


识 


` 


如 前 面 所 讲 ，Zuul 请 求 的 前 面 是 反 向 代理 和 负载 ， 那 么 在 反 辐 代 


青 求 路 径 时 ， 如 
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果 只 有 这 一 个 服务 集群 需要 映射 ， 那 么 表 定 是 能 正确 分 发 到 Zuul 服务 的 ， 如 果 反 向 代理 负责 映 
射 多 个 服务 集群 ， 而 多 个 服务 集群 中 难免 会 有 某 些 服务 的 请 求 路 径 是 相同 的 ， 这 种 情况 就 需要 
给 同一 集群 内 的 服务 分 配 一 个 统一 的 前 级 。 
zuul: 
prefix: /springcloud 
strip-prefix: true 
routes: 
consumer: 
path: /consumer/** 
strip-prefix: false 
service-id: SERVICE-CONSUMER 
provider: 
path: /user/** 
strip-prefix: false 
service-id: SERVICE-PROVIDER 


上 面 代码 中 ， 对 此 Zuul 服务 通过 prefix 属性 添加 一 个 统一 的 前 绥 /springcloud， 并 且 在 进行 
具体 服务 映射 之 前 删 掉 此 前 级 。 从 而 在 反 向 代理 中 通过 识别 此 前 级 ， 即 可 映射 相应 集群 ， 实 现 
通过 请 求 路 径 标明 集群 的 目的 。 如 图 9-24 所 示 。 


Headers 


图 9-24 自 定 义 的 路 由 请 求 


(4) 隐藏 服务 端口 
Zuul 会 自动 为 集群 内 的 服务 提供 负载 ， 供 外 网 访问 ， 但 有 时 不 希望 某 些 服务 的 接口 暴露 给 
外 网 ， 所 以 可 以 通过 ignored-services 配置 来 设置 某 些 服务 不 需要 Zuul 提供 负载 。 


zuul: 
prefix: /springcloud 
strip-prefix: true 
ignored-services: SERVICE-PROVIDER 
routes: 
consumer: 

path: /consumer/** 

strip-prefix: false 

service-id: SERVICE-CONSUMER 
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的 映射 规划， 并且 在 Zuul 的 ignored-services 配置 项 中 添加 


Provider 服务 的 ServiceIld， 这 样 Zuul 就 不 会 把 Provider 服务 的 接口 暴露 出 去 。 使 用 Postman 无 


法 通过 Zuul 访问 Provider? 服 务 的 接 


， 如 图 9-25 所 示 。 


Value Des 


图 9-25 服务 屏 项 后 的 访问 情况 


(5) 其 他 配置 
Zuul 标签 下 还 有 一 些 其 他 配置 ， 


例如 host 中 包含 连接 数 和 超时 时 间 等 配置 ，ignored-*# 标 签 


可 以 对 不 同类 型 数据 进行 过 滤 等 ， 这 些 配置 的 使 用 要 在 实际 项 目 中 根据 具体 需要 进行 选择 。 


9.4.3 Filter 基本 使 用 


可 以 通过 自 定义 Filter 来 实现 在 Zuul 网 关上 的 请 求 拦截 与 过 滤 。 在 同一 个 Zuu 服务 中 ， 可 
以 定义 多 个 Filter， 多 个 Filter 根据 分 类 和 优先 级 的 定义 有 序 执行 ， 这 种 有 序 的 关系 也 便于 把 一 


些 通 用 并 且 简单 的 过 滤器 放 到 前 面 ， 


个 过 滤器 的 状态 选择 性 执行 ， 从 而 节省 服务 器 开销 。 下 面 介 绍 Filter 的 使 用 方法 。 


(1) Filter 简单 实现 


@Component 


如 果 这 个 过 滤器 验证 不 通过 ， 后 面 的 过 滤器 通过 检测 上 一 


在 Zuul 工程 中 创建 一 个 CommonFilter 类 ， 这 个 类 实现 如 下 。 


public class CommonFilter extends ZuulFilter { 
ObjectMapper mapper = new ObjectMapper(); 


@Override 
public Object run() { 
try { 


RequestContext ctx = RequestContext.getCurrentContext(); 

HttpServletRequest request = ctx.getRequest(); 

String versionString = request.getHeader("version"); 

String typeString = request.getHeader("clienttype"); 

if(versionString!=null && typeString!=null) { 
ctx.setSendZuulResponse(true); 
ctx.set("isFilterSuccess", true); 


yelse { 


ctx.setSendZuulResponse(false); 


O 为 了 演示 方便 ， 后 面 的 例子 中 放 开 了 对 Provider 服务 的 屏蔽 。 
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ctx.set("isFilterSuccess", false); 
ctx.setResponseStatusCode(400); 
Result<String> result = new Result>(ResultCode.Bad_Request); 
ctx.setResponseBody(mapper.write ValueA sString(result)); 
} 
} catch (Exception e) { 
e.printStackTrace(); 
RequestContext ctx = RequestContext.getCurrentContext(); 
ctx.setSendZuulResponse(false); 
ctx.set("isFilterSuccess", false); 
ctx.setResponseStatusCode(400); 
} 
return null; 


} 


@Override 
public boolean shouldFilter() { 
return true; 


j 


@Override 
public int filterOrder() { 
return 0; 


} 


@Override 
public String filterType() { 
return "pre"; 


} 
} 
(2) 方法 含 》 
CommonFilter 继承 自 ZuulFilter 抽象 类 ， 并 且 实 现 了 4 个 抽象 方法 ， 其 含义 见 表 9-2. 


表 9-2 ”ZuulFilter 抽象 方法 


方法 名 ae x 说 WY 
pre: 请 求 路 由 前 被 调用 
filter Type 过 滤器 类 型 Le peed te 误 时 被 调 
post: 在 route 和 error 之 后 被 调 月 
filterOrder 过 滤器 优先 级 数字 越 小 ， 越 先 执行 
shouldFilter 过 滤器 是 否 执行 的 判断 true 表示 执行 
run 过 滤器 具体 逻辑 可 以 通过 此 方法 对 数据 进行 检测 ， 并 且 可 以 提前 结束 路 


在 上 面 的 例子 中 ， 在 run 方法 中 验证 了 请 求 头 中 是 否 包 含 version 和 clienttype 这 两 个 数据 
项 ， 如 果 不 包 含 则 验证 不 通过 ; 方法 中 使 用 ctx.set("isFilterSuccess"，boolean) 在 上 下 文中 存放 了 
一 个 数据 ， 可 以 使 用 这 种 方法 传递 Filter 之 间 的 数据 。 
(3) 实际 效果 演示 
如 果 不 添加 version 和 clienttype 这 两 个 数据 项 ， 则 不 能 验证 通过 ， 效 果 如 图 9-26 所 示 。 
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GET p://47.95.113.117:18040/springcloud/user/7 
eaders 
Key Value 
Bod 4 
Pretty = 
resultCode 400 
"msg": "bad request!", 
"data": null 
} 


图 9-26 不 带 Header 参数 的 请 求 


添加 Header 信息 后 ， 可 以 正确 返回 数据 ， 如 图 9-27 所 示 。 
GET http://47.95.113.117:18040/springcloud/user/7 
clienttype 
Body 4 


图 9-27 "ir Header 参数 的 请 求 


9.4.4 ”简单 的 鉴 权 服务 


o 


Spring Cloud 


已 
已 


户 的 登录 鉴 权 可 以 放 到 Zuul 的 Filter 中 进行 ， 也 可 以 新 建 一 个 服务 专门 作为 用 户 登录 鉴 
权 使 用 。 这 里 新 建 一 个 Spring Boot 工程 ， 叫 作 SpringCloudAuth°， 专 门 对 外 提供 鉴 权 色 
Filter 可 以 调用 此 服务 从 而 实现 鉴 权 验 证 


在 此 工程 中 ， 对 外 提供 两 个 接口 ， 一 个 是 获取 用 户 token〔 令 牌 》 的 接口 ， 男 一 个 是 验证 


J token 的 接口 。 集 群 中 的 服务 在 被 访问 前 ， 都 会 先 通 过 Zuul 去 此 服务 验证 token， 验 证 通过 才 
能 继续 访问 集群 服务 ， 否 则 不 允许 访问 2。 


O 在 此 演示 的 服务 实现 仅仅 是 一 个 鉴 权 服务 的 主要 思路 ， 并 非 真 正 的 鉴 权 服务 ， 这 个 示例 还 需 扩充 能 力 ， 例 如 生成 的 token 应 该 
缓存 起 来 ，token 应 该 具备 时 效 性 ， 不 同 的 账号 会 有 不 同 的 权限 等 ， 大 家 可 以 自己 丰富 鉴 权 服务 的 实现 或 者 使 用 一 些 开源 的 鉴 权 组 件 。 
© 此 Auth 服务 可 以 加 入 微服 务 集群 中 ， 这 样 就 需要 在 获取 token 时 ， 在 用 户 鉴 权 Filter 中 对 路 径 进行 特殊 处 理 ， 不 进行 token 验 
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证 ， 和 否则 用 户 在 没有 token 的 情况 下 永远 无 法 获取 token。 可 以 使 用 判断 HttpServletRequest 中 请 求 路 径 的 方法 ， 若 发 现 是 获取 token 的 请 
则 不 进行 token 验证 。 
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(1) 添加 Controller 类 接口 。 


@RestController 
@RequestMapping("/auth") 
public class AuthController { 
class Admin { 
public int id = 1; 
public String name = "admin"; 
public String password = "password"; 


j 
private Admin admin = new Admin(); 


@RequestMapping(value="/gettoken",method=RequestMethod.GET) 
public Result<String> getToken(@RequestParam("name") String name,@RequestParam("password") 
String password) { 
if(name!=null && password!=null && name.equals(admin.name) && 
password.equals(admin.password)) { 
String token = generateToken(); 
Result<String> result = new Result<>(ResultCode.OK, token); 
return result; 
yelse { 
Result<String> result = new Result<>(ResultCode.Bad_Request); 
return result; 


} 


@RequestMapping(value="/validtoken",method=RequestMethod.GET) 
public Result<String> validToken(@RequestParam("token") String token) { 
if(token != null && token.equals(generateToken())) { 
Result<String> result = new Result<>(ResultCode.OK); 
return result; 


j 

else { 
Result<String> result = new Result<>(ResultCode.Bad_Requesb; 
return result; 

} 


} 


private String generateToken() { 
StringBuilder stringBuilder = new StringBuilder(); 
stringBuilder.append(admin.id).append(admin.name).append(admin.password); 
try { 
return md5Encode(stringBuilder.toString()); 
} catch (Exception e) { 
e.printStackTrace(); 
} 
return null; 


j 


private String md5Encode(String inStr) throws Exception { 
MessageDigest md5 = null; 
try { 
md5 = MessageDigest.getInstance("MD5"); 
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} catch (Exception e) { 

System.out.println(e.toString()); 

e.printStackTrace(); 

return ""; 


} 


byte[] byteArray = inStr.getBytes("UTF-8"); 
byte[] md5Bytes = md5.digest(byteArray); 
StringBuffer hex Value = new StringBuffer(); 
for (int i= 0; 1<md5Bytes.length; i++) { 
int val = ((int) mdS5Bytes[i]) & Oxff; 
if (val < 16) { 
hex Value.append("0"); 


j 
hexValue.append(Integer.toHexString(val)); 
} 
return hex Value.toString(); 


} 
在 Controller 类 中 提供 了 一 个 默认 的 账号 密码 ， 当 getToken 接口 使 用 此 账号 密码 获取 token 
时 ， 如 果 都 验证 正确 ， 可 以 返回 一 个 简易 的 token， 此 token 是 用 字符 串 拼 接 的 并 且 进 行 了 一 次 
MD59; 当 validToken 接口 进行 token 验证 时 ， 使 用 接口 获取 的 值 和 系统 的 token 进行 验证 ， 二 
者 相同 则 验证 通过 。 

(2) 获取 token 
使 用 Postman 先 获取 token 如 下 : c8a02ee0a25f0ec1dd6c5df642c304da。 如 图 9-28 所 示 。 


图 9-28 ”获取 token 信息 


9.4.5 Filter 使 用 其 他 服务 进行 鉴 权 

新 建 一 个 AuthFilter， 此 Filter 调用 上 一 小 节 的 鉴 权 服务 进行 token 的 验证 ， 使 用 Feign 进行 
服务 间 调 用 ， 所 以 要 添加 Feign 的 相关 配置 ， 具 体 配置 方法 参照 之 前 的 章节 ， 如 果 验 证 通过 则 对 
服务 进行 路 由 。 下 面 列 出 Feign 和 Filter 的 代码 。 


© Message Digest Algorithm MDS 〈 中 文 名 为 消息 摘要 算法 第 5 版 ) 为 计算 机 安全 领域 广泛 使 用 的 一 种 散 列 函数 ， 用 以 提供 消息 的 
完整 性 保护 。 
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@FeignClient(name="auth" url="http://172. 17.238.237:18070") 
public interface AuthFeign { 
@RequestMapping(value="/auth/gettoken" method=RequestMethod.GET) 
public Result<String> getToken(@RequestParam("name") String name,@RequestParam("password") 
String password); 


@RequestMapping(value="/auth/validtoken" method=RequestMethod.GET) 
public Result<String> validToken(@RequestParam("token") String token); 


} 


@Component 

public class AuthFilter extends ZuulFilter{ 
ObjectMapper mapper = new ObjectMapper(); 
@Autowired 
private AuthFeign feign; 


@Override 

public boolean shouldFilter() { 
RequestContext ctx = RequestContext.getCurrentContext(); 
return (boolean) ctx.get("isFilterSuccess"); 


} 


@Override 
public Object run() { 
try { 
RequestContext ctx = RequestContext.getCurrentContext(); 
HttpServletRequest request = ctx.getRequest(); 
String token = request.getHeader("token"); 
if(token!=null) { 
Result<String> authResult = feign. validToken(token); 
if(authResult.getResultCode() = 200) { 
ctx.setSendZuulResponse(true); 
ctx.set("isFilterSuccess", true); 
yelse { 
ctx.setSendZuulResponse(false); 
ctx.set("isFilterSuccess", false); 
ctx.setResponseStatusCode(401); 
Result<String> result = new Result<>(ResultCode.Unauthorized); 
ctx.setResponseBody(mapper.write ValueA sString(result)); 
} 
yelse { 
ctx.setSendZuulResponse(false); 
ctx.set("isFilterSuccess", false); 
ctx.setResponseStatusCode(400); 
Result<String> result = new Result<>(ResultCode.Bad_Request); 
ctx.setResponseBody(mapper.write ValueA sString(result)); 
} 
} catch (Exception e) { 
e.printStackTrace(); 
RequestContext ctx = RequestContext.getCurrentContext(); 
ctx.setSendZuulResponse(false); 
ctx.set("isFilterSuccess", false); 
ctx.setResponseStatusCode(400); 
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} 
return null; 


j 


@Override 
public String filterType(Q) { 
return "pre"; 


j 


@Override 
public int filterOrder() { 
return 1; 
} 
} 
AuthFilter 类 中 的 fterOrder 方法 返回 的 数字 是 1， 所 以 这 个 filter 会 晚 于 CommonFilter 执 
行 ，shouldFilter 方法 中 ， 使 用 从 上 一 个 Filter 获取 的 数据 ， 如 果 请 求 没 有 通过 上 一 个 过 滤器 ， 那 
么 本 过 滤器 不 执行 。 
通过 Postman 调用 结果 如 图 9-29 所 示 。 


图 9-29 iF token 的 请 求 


9.4.6 Zuul 的 其 他 使 用 方法 

C1) 监控 

Zuul 依赖 默认 集成 了 Hystrix， 所 以 添加 Zuul 的 监控 非常 简单 ， 只 要 在 配置 文件 中 添加 服 
务 分 组 信息 eureka.instance.metadata—map.cluster=main©, EN FE Zuul 服务 的 监控 聚合 到 
Turbine 上， 如 图 9-30 所 示 。 


O 这 里 使 用 此 风格 是 为 了 便于 横向 书写 ， 项 目 代码 中 采用 的 是 yaml 形式 的 书写 方式 。 
O 这 里 需要 保证 Zuul 与 Turbine 的 数据 采集 方式 统一 ， 默 认 情 况 下 Zuul 不 是 通过 消息 队列 采集 的 ， 如 果 Turbine 想 通过 消息 队列 
， 那 么 Zuul 上 也 要 配置 消息 队列 ， 如 果 Zuul 不 想 使 用 消息 队列 ， 那 么 两 者 都 要 改 为 非 消息 队列 的 采集 方式 。 


my 


aint 


采 
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Hystrix Stream: turbine 


Circuit Sort: Error then Volume | Alphabetical | Volume | Error | Mean | Median | 90 | 99 


99.5 


ConsumerFeign#getUser(int) SERVICE-CONSUMER 
4,182 94 


0/0 0/0 
0 
116.0/s 109.2/s 
116.0/s 109.2/s 
Circuit Close Circuit Closed 
Hosts 1 36ms Hosts 1 90th 64ms Hosts 
Median 12ms 99th 99ms Median 20ms 99th 130ms Median 
Mean 17ms 99.5th 104ms Mean 30ms 99.5th 156ms Mean 


Thread Pools 


Sort: Alphabetical | Volume | 


provider-getuser 
1,119 0 


0/0 
0 


27.7/s 

55.4/s 

Circuit Close 

2 90th 10ms 
3ms 99th 139m 
7ms 99.5th 149ms 


SERVICE-PROVIDER provider-usercontroller 


112.7/s 28.3/s 

112.7/s 56.5/s 

Active 0 Max Activ 10 Active 1 Max e 16 

Queued 0 Execution: 1,127 Queued 0 Executions 1,130 

ol Size 100 Queue Siz Pool Size 200 Queue Size 5 
图 9-30 if Zuul 服务 的 监控 页 面 


ens 
(2) 高 可 用 
Zuul 的 高 可 用 相对 简单 ， 在 微服 务 集群 中 不 
在 前 面 的 负载 中 完成 Zuul 服务 的 负载 策略 即 可 。 


9.5 Config 


Config 是 Spring Cloud 微服 务 集群 


的 配置 


心 ， 可 以 把 各 个 服务 的 配置 通过 Config 服务 进 


图 可 见 ，Zuul 的 监控 级 别 是 服务 级 的 ，SERVICE-CONSUMER 就 是 从 Zuul 获取 的 监 


进行 什么 配置 ， 启 动 多 台 Zuul 服务 的 实例 ， 


行 统一 获取 ， 这 样 可 以 保证 配置 文件 的 集中 管理 ， 同 时 可 以 针对 某 些 配置 进行 动态 的 更 新 ， 这 


样 也 解决 了 业务 服务 更 新 配置 时 重新 部 署 的 问题 。 
9.5.1 配置 Config 服务 端 


Config 服务 也 是 个 Spring Boot 程序 。 基 本 的 Config 服务 主要 配置 三 个 地 方 : pom 文件 、 


yml 文件 和 局 动 类 ， 但 是 有 
真实 的 配置 文件 的 存放 组 件 。Config 对 多 种 版 本 管理 
进行 了 支持 ， 本 节 使 用 Git 作为 配置 文件 存放 的 工具 。 


~ 


个 特殊 的 地 方 是 Config 服务 需要 配置 一 个 版 本 管理 服务 器 ， 用 作 


表 9-3 目录 结构 


(1) 建立 Git 工程 存放 配置 ax [rx 文人 
在 Git 中 创建 一 个 工程 ， 工 程 路 径 如 下 : https://gitee. Sve sens de yi 
com/hwhe/SpringCloudConfig.git。 在 此 工程 中 ， 创 建 两 个 。” ae servie On Mimet prod yml 
分 文 ， 一 个 是 master 默认 分 文 ， 一 个 是 dev 分 文 。 Service, era 
两 个 分 支 中 的 目录 结构 见 表 9-3。 serviceprovider-prod.yml 
两 个 分 支 的 文件 结构 相同 ， 在 不 同 的 分 文中 ， 可 以 service- earl dev fal 
民 据 服务 需要 设置 不 同 的 配置 内 容 。 后 面 会 在 Config 服 aay | eens vies one prod yml 
Zp, WEHR, JEFA profile 和 分 文 获取 不 同 的 配 service provider dev yr 
ari, service-provider-prod.yml 
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(2) Config 服务 配置 
在 pom 文件 中 ， 添 加 如 下 依赖: 


<dependency> 
<groupld>org.springframework.cloud</groupId> 
<artifactld>spring-cloud-config-server</artifactld> 
</dependency> 


mM 


车 启动 类 中 ， 添 加 @EnableConfigServer 注解 。 
Æ yml 文件 中 ， 添 加 如 下 配置 : 


PE 


server: 
port: 18050 


spring: 
application: 
name: config-server 
cloud: 
config: 
server: 
git: 
uri: https://gitee.com/hwhe/SpringCloudConfig. git 
search-paths: configs 
username: your@mail.com 
password: yourpassword 


上 面 的 配置 中 ，uri 是 Git 服务 的 地 址 ，search-paths 是 Git 工程 的 文件 夹 ， 这 里 对 应 Git T 
程 的 configs FIZ; username 和 password 是 Git 的 账号 密码 。 

(3) 通过 Config 获取 配置 

可 以 通过 请 求 Config 服务 来 获取 Git 上 的 配置 属性 ， 有 具体 请 求 可 以 使 用 Config 服务 地 址 加 
“/{applicationname}/{profile}/{label} ”路 径 的 形式 来 获取 ， 获 取 的 内 容 如 下 。 使 用 Postman 请 求 
效果 如 图 9-31 所 示 。 


"name": "SpringCloudServiceProvider", 
"profiles": [ 
"dev" 
lb 
"label": null, 
"version": "f30aa5b053cb6 13dd9ce503967592326928fba5b", 
"state": null, 
"propertySources": [ 
{ 
"name": "https://gitee.com/hwhe/SpringCloudConfig. git/configs/service-provider-dev.yml", 
"source": 
"custom.foo": "springcloudprovider-dev label is master" 
} 
} 
] 
} 
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GET http://localhost:18050/service-provider/dev Para’ 
Body 4 — 
Pretty = 
s://gitee.com/hwhe/SpringCloudConfig.git/configs/service-provil 
“springcloudprovider-dev label is master” 
} 
] 
} 
图 9-31 获取 配置 信息 


EW 


自 


AG» 


由 图 可 见 ， 使 用 Postman 工具 获取 
上 的 配置 项 ， 而 没有 使 用 label， 这 是 因为 在 不 设 


ot 


200 OK 


ider-dev.yml", 


me: 3908 ms 


Save 


ize: 475 


B 


仅 使 用 /{applicationname}/{profile} 路 径 就 得 到 了 Git 
label 的 情况 下 ， 默 认 使 


J master 分 支 。 在 获 


取 的 数据 中 ，propertySources 属性 下 的 


内 容 是 Git 的 文件 地 址 信息 和 配置 项 。 


下 


种 尝试 在 路 径 中 添 


DH label 来 获取 dev 分 文 下 的 数据 ， 获 取 的 内 容 如 下 。 使 用 Postman 请 求 效 果 如 图 9-32 所 示 。 


GET http://localhost:18050/service-provide 


Obaefbcbcd3be9047 36ee3ca60936a53354a72", 


:I[ 
"name": "ht 
"source": { 

"custom. foo": 


tps://gitee.com/hwhe/SpringCloudConfig.git/con 


"springcloudprovider-dev label is dev" 


9-32 ”获取 配 


"name": "SpringCloudServiceProvider", 
"profiles": [ 
"dev" 
Ih 
"label": "dev", 
"version": "6a26fc099b 1 63fae362.df3872425c3d5db12c734", 
"state": null, 
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yider-dev.yml", 


v 


Save 
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"propertySources": [ 


{ 
"name": "https://gitee.com/hwhe/SpringCloudConfig.git/configs/ SpringCloudServiceProvider- dev.yml", 


"source": 
"custom.foo": "springcloudprovider-dev label is dev" 


} 


} 
可 以 使 用 spring.cloud.config.server.default-label 属性 来 设置 默认 的 分 支 ， 这 样 这 个 分 支 就 成 
为 Config 服务 的 默认 数据 源 。 


9.5.2 ”服务 通过 Config 获取 配置 

本 节 先 演示 业务 服务 Consumer 在 程序 中 获取 一 个 本 服务 自 定 义 的 配置 ， 然 后 再 加 入 Config 
服务 的 客户 端 依 赖 ， 使 用 Config 服务 获取 配置 ， 并 且 观 察 配 置 的 优先 级 别 。 

( 1 ) 服务 中 获取 自 定 义 配 置 
在 yml 文件 中 ， 添 加 如 下 配置 ， 自 定义 一 个 custom.foo 属性 ， 里 面包 含 了 一 些 标记 信息 。 


custom: 
foo: application config version 1 


更 改 Consumer 服务 的 Controller， 添 加 如 下 代码 ， 可 以 通过 接口 获取 配置 信息 。 


@Value("$ {custom.foo}") 
String fooValue; 


H 


@RequestMapping(value="/foo",method=RequestMethod.GET) 
public Result<String> getFoo() { 
Result<String> result = null; 
if(fooValue!=null) { 
result = new Result<>(ResultCode.OK, fooValue); 


yelse { 
result = new Result<>(ResultCode.Not_Found); 


} 
return result; 


} 

通过 Postman 直接 访问 服务 的 接口 可 以 得 到 配置 信 
息 ， 如 图 9-33 所 示 。 

(2) 从 Config 服务 获取 配置 Dee 

业务 服务 可 以 通过 Config 服务 获取 配置 信息 ， as Value 
只 要 在 存储 配置 信息 的 Git 工程 ! 深 加 服务 对 应 的 配 
置 项 ， 在 业务 服务 中 添加 Config 客户 端 依赖 ， FFA 
新 建 一 个 bootstrap.yml 文件 ， 配 置 Config 服务 的 信 一 一 
县 即 可 。 sac, 
添加 Git 配置 信息 : 
在 管理 配置 文件 的 Git 工程 中 ， 选 择 master 分 支 的 
service-consumer-devyml 文件 ， 在 其 中 添加 如 下 配置 : 


图 9-33 通过 接口 获取 配置 
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custom: 
foo: configserver config version 1 from master 


在 Consumer 工程 中 添加 依赖 : 


<dependency> 
<groupId>org.springframework.cloud</groupId> 
<artifactId>spring-cloud-starter-config</artifactId> 
</dependency> 


在 Consumer 工程 中 添加 bootstrap.yml 文件 ， 并 且 进 行 如 下 配置 : 


Spring: 
application: 
name: Service-consumer 
cloud: 
config: 
profile: dev 
uri: http://localhost:18050/ 


在 bootstrap.yml 文件 中 设置 业务 服务 名 ，Config 服务 的 uri 地 址 和 选择 的 profile。 先 后 启动 
Config 服务 和 Consumer 服务 ， 通 过 Postman 获取 foo 信息 ， 如 图 9-34 所 示 。 


tI 
t 


图 9-34 通过 接口 获取 配置 


了 业务 服务 本 身 的 配置 ， 这 是 Spring Boot 的 配置 优先 级 导致 的 。 


请 求 输 出 结果 可 见 ， 可 以 通过 Config 服务 获取 配置 ， 并 且 从 Config 服务 获取 的 配置 覆盖 


如 果 业 务 服 务 想 从 其 他 分 支 获 取 配 置 ， 只 要 在 bootstrap.yml 文件 中 添加 


spring.cloud.config.label= {branch 具体 分 支 } 配 置 即 可 。 


9.5.3 ”添加 加 密 


如 果 想 对 配置 进行 保护 ， 可 以 在 Config 服务 中 设 定 账号 密码 ， 这 样 只 


的 服务 才能 获取 配置 。 
(1) Config 服务 添加 安全 组 件 

在 pom 文件 中 添加 如 下 依赖 
<dependency> 


<groupld>org.springframework.boot</groupId> 
<artifactId>spring—boot-starter-security</artifactld> 
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有 配置 了 此 账号 密码 


在 yml 文件 中 添加 如 下 配置 : 


(2) 


</dependency> 


security: 
user: 
name: user 
password: password 


应 用 服务 添加 账号 密码 


把 Consumer 工程 的 bootstrap.yml 文件 修改 为 如 下 内 容 : 


spring: 
application: 
name: service-consumer 
cloud: 
config: 
profile: dev 
uri: http:/Aocalhost:18050/ 
username: user 
password: password 


这 样 就 完成 了 最 简单 的 账号 密码 的 验证 。 
9.5.4 通过 Config 服务 名 读 取 配置 


前 面 介绍 的 业务 服务 直接 配置 了 Config 服务 的 IP 地 址 进行 配置 


也 可 以 通过 Eureka 的 注册 发 现 能 力 ， 让 其 他 服务 通过 服务 名 去 访问 ， 


多 台 实 例 


要 实现 此 能 力 只 要 完成 两 件 事 ,一 是 C Coin 服务 完成 Eureka 的 本 
再 重复 介 


到 Eurek 
bootstrap 


即 可 实现 服务 的 高 可 用 。 


a 上 ， 关 于 此 配置 前 面 已 经 介绍 很 多 ， 这 里 就 不 
文件 中 ， 修 改 为 如 下 配置 : 


spring: 
application: 
name: service-consumer 
cloud: 
config: 
profile: dev 
discovery: 
enabled: true 
service-id: CONFIG-SERVER 
username: user 
password: password 


eureka: 

instance: 
hostname: service-consumer 
instance-id: ${spring.cloud.client.ipAddress}:$ {server.port} 
prefer-ip-address: true 
metadata—map: 

cluster: main 

client: 

region: javadevmap 


FE == 


OR 


Spring Cloud 


的 获取 ， 


实 Config 服务 


这 样 Config 服务 只 要 配置 


cu 
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二 是 在 业务 服务 的 
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availability—zones: 
javadevmap: map_eureka 


service-url: 
map_ eureka: http://172.17.238.237:18001/eureka/,http://172.17.238.239:18001/eureka/ 


件 。 另 外 一 个 不 同 的 地 方 就 是 去 掉 了 spring.cloud.config.uri 配置 ， 添 加 了 spring.cloud. 
discovery 配置 ， 添 加 此 配置 后 ， 业 务 服务 将 通过 服务 名 查找 Config 服务 获取 配置 。 


9.5.5 ”配置 动态 刷新 


这 里 做 的 事情 主要 是 把 Eureka 的 相关 配置 从 application.yml 文件 中 移 至 bootstrap.yml X 


config. 


如 果 想 更 新 一 条 业务 配置 ， 但 是 由 于 菜 些 原因 又 不 能 重新 启动 业务 服务 ， 这 个 时 候 就 用 到 


要 实现 此 能 力 ， 只 要 基于 之 前 的 工作 ， 并 且 在 业务 服务 中 保证 /refresh 端点 可 访问 ， 在 需要 


新 属性 值 的 类 上 方 添加 @RefreshScope 注解 即 可 。 
a) 配置 业务 服务 


aa 
= 


在 Consumer 工程 的 yml 文件 中 ， 添 加 如 下 配置 ， 此 配置 添加 了 Amefresh 端点 ， 并 
安全 认证 。 
endpoints: 

refresh: 


enabled: true 
sensitive: false 


在 Controller 类 的 上 方 添加 @RefreshScope 注解 。 
(2) 动态 配置 演示 

首先 通过 接口 直接 获取 配置 项 ， 可 以 得 到 如 下 返回 ;: 
{ 


"resultCode": 200, 
"msg": "ok", 
"data": "configserver config version 1 from master" 


j 
修改 Git 配置 工程 中 对 应 的 文件 信息 ， 改 为 : 


custom: 
foo: configserver config version 2 from master 


屏蔽 了 


再 次 通过 接口 获取 服务 的 配置 项 ， 发 现 配 置 项 的 返回 没有 变化 。 这 时 需要 调用 此 服务 的 


/refresh 端点 。 用 post 请 求 调用 http://47.95.113.117:18020/refresh 后 ， 再 通过 /consumerfoo 接口 获 


取信 息 ， 可 以 得 到 如 下 返回 数据 : 
{ 
"resultCode": 200, 
"msg": "ok", 
"data": "configserver config version 2 from master" 
} 


9.5.6 ”批量 刷新 配置 
上 一 节 实 现 了 动态 刷新 ， 但 是 这 种 使 用 方法 在 服务 实例 众多 的 时 候 明 显 不 太 合适 ， 
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种 办 法 ， 能 够 实现 批量 的 服务 刷新 ? 这 就 需要 总 线 


刷新 。 有 没有 


个 服务 都 要 调用 /refresh 进行 


来 进行 配合 了 。 
在 Config 服务 上 配置 总 线 的 地 址 ， 并 且 在 业务 服务 
Config 服务 的 /bus/refresh 端口 ， 总 线 就 会 通知 所 有 服务 进行 刷新 。 


(1) 服务 配置 
在 Config 服务 和 业务 服务 的 pom 文件 中 添加 如 下 依赖 : 


<dependency> 
<groupld>org.springframework.cloud</groupId> 


<artifactlId>spring-cloud-starter-bus-amgp</artifactld> 


配置 总 线 的 地 址 。 这 样 只 要 调用 


| 
j 


</dependency> 


在 Config 服务 和 业务 服务 的 yml 文件 ! 


Spring: 
rabbitmq: 
host: 172.17.238.238 


port: 5673 
username: guest 
password: guest 
这 样 就 完成 了 批量 刷新 的 全 部 配置 工作 。 
(2) 全 量 服务 刷新 
所 有 服务 启动 后 ， 修 改 Git 文件 的 配置 。 例 如 把 master 分 文 上 的 service-consumer-dev.yml 
文件 修改 为 : 


custom: 
foo: configserver config version 3 from master 
调用 Config 服务 刷新 ， 由 于 对 Config 服务 添加 了 安全 组 件 ， 所 以 在 Postman 中 提交 刷新 


» security 
Params Send v Sav 


添加 RabbitMQ 的 配置 : 


POST ttp://47.95.113.117:18050/bus 
Description 


TYPE 


图 9-35 ZEA E 


的 是 ， 刷 新 是 post 请 求 ， 并 且 路 径 是 
服务 刷新 

如 果 只 想 刷 新 某 个 
Consumer 服务 ， 可 以 使 月 


/bus/refresh. 


。 例 如 只 刷新 


添加 destination=applicationname 


服务 ， 可 以 在 请 求 路 径 
日 如 下 请 求 ， 如 图 9-36 所 示 。 
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图 9-36 特定 服务 刷新 


9.6 Sleuth 与 Zipkin 


现在 集群 中 主要 包含 两 个 业务 服务 ， 一 个 是 Consumer， 另 一 个 是 Provider， 调 用 关系 非 
常 清晰 。 但 是 如 果 集 群 内 业务 不 断 健 全 ， 新 功能 不 断 增加 ， 而 微服 务 的 数量 也 不 断 增 加 ， 想 
搞 明 白 一 个 业务 具体 调用 了 哪些 服务 以 及 整个 调用 链 中 性 能 瓶颈 出 现在 哪里 ， 就 会 变 得 越 来 
越 困 难 。 
在 这 种 情况 下 ， 可 以 添加 Sleuth 和 Zipkin 来 跟踪 服务 链 路 情况 。Sleuth 提供 了 信息 采集 的 
能 力 ， 它 可 以 对 一 个 请 求 分 配 唯一 的 id， 整 个 链 路 中 所 有 调用 路 径 都 会 记录 此 id， 同 时 Sleuth 
还 对 每 一 次 操作 进行 了 更 加 详细 的 记录 ， 本 会 在 后 面 讲解 Sleuth 的 记录 内 容 。Zipkin 可 以 从 
多 台 服 务 器 中 采集 这 些 记录 信息 ， 进 行 统一 的 整理 、 展 示 和 数据 存储 。 本 节 详 细 介绍 这 两 个 组 
件 的 使 用 方法 。 


9.6.1 Sleuth 信息 采集 
Sleuth 具备 信息 采集 能 力 ， 只 要 在 业务 服务 中 添加 如 下 依赖 即 可 。 


<dependency> 
<groupId>org.Springframework.cloud</groupId> 
<artifactId>spring-cloud-starter-sleuth</artifactId> 
</dependency> 


如 何 确认 信息 已 经 被 Sleuth KEENE? 可 以 修改 之 前 配置 的 logback-spring.xml 日 志文 件 ， 把 
信息 的 输出 部 分 
<pattern>%d {yyyy-MM-dd} %d{HH:mm:ss.SSSZ} %-Slevel %logger{36}[${APP Name} ], 

[%15.15t] : Ym%n%wEx</pattern> 


改 为 


XI 


<pattern>%d{yyyy-MM-dd} %d{HH:mm:ss.SSSZ} %-5level %logger{36} [${APP Name}, %16X{X- 

B3-Traceld}, %16X{X-B3-SpanId}, %5X {X-Span-Export} ], [%15.15t] : %m%n%wEx</pattern> 
这 样 ， 就 可 以 对 比 修改 前 后 的 服务 调用 ， 可 以 看 到 输入 的 日 志 中 多 出 如 下 内 容 : 
[，3bd7d8737aaca993，3bd7d8737aaca993，false]， 这 些 就 是 通过 Sleuth 采集 到 的 数据 ，Traceld 就 
是 服务 调用 的 唯一 标识 ，Sleuth 会 保证 此 id 在 同一 请 求 中 保持 唯一 。Spanld 是 各 个 任务 的 id。 
现在 虽然 在 日 志 中 记录 了 调用 链 路 的 唯一 标识 ， 但 是 逐个 服务 实例 查看 一 个 请 求 的 Traceld 
明显 是 不 现实 的 ， 所 以 需要 一 个 聚合 的 展示 工具 ， 下 面 就 用 到 了 Zipkin。 
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9.6.2 Zipkin 数据 聚合 展示 


Sleuth 记录 的 信息 分 散在 各 个 节点 中 ， 可 以 通过 Zipkin 进行 统一 的 收集 和 分 析 。 使 用 
Spring Boot 建立 一 个 工程 ， 工 程 名 叫 SpringCloudZipkin， 然 后 完成 Zipkin 组 件 的 引用 和 配置 ， 
即 可 搭建 一 个 Zipkin 服务 。 

(1) 搭建 Zipkin 服务 

添加 Zipkin 服务 的 依赖 组 件 


<dependency> 
<groupld>io.zipkin.java</groupId> 
<artifactld>zipkin-server</artifactld> 
</dependency> 
<dependency> 
<groupId>io.zipkin.java</groupId> 
<artifactld>zipkin-autoconfigure—ui</artifactld> 
</dependency> 


在 启动 类 中 添加 注解 @EnableZipkinServer， 在 ym 文件 中 设置 服务 的 端口 为 18060, RI 
名 为 zipkin-server. 

(2) 配置 业务 服务 
在 Consumer 和 Provider 业务 服务 中 ， 添 加 如 下 依赖 ， 可 以 把 Sleuth 收集 到 的 数据 发 送 至 
Zipkin 服务 。 


<dependency> 
<groupId>org.springframework.cloud</groupId> 
<artifactId>spring-cloud-starter-sleuth</artifactId> 

</dependency> 

<dependency> 
<groupId>org.springframework.cloud</groupId> 
<artifactId>spring-cloud-sleuth-zipkin</artifactId> 

</dependency> 


在 yml 配置 文件 中 添加 如 下 配置 


spring: 
zipkin: 
enabled: true 
sender: 
type: web 
base-url: http://172.17.238.237:18060 
sleuth: 
enabled: true 
rxjava: 
schedulers: 
hook: 
enabled: false 
sampler: 
percentage: 1.0 


此 配置 中 ， 通 过 spring.zipkin.base-url 设置 了 Zipkin 服务 器 的 地 址 ; 通过 spring. 
zipkin.sender.type 指定 了 发 送 类 型 ， 在 spring.sleuth 中 关闭 了 rxjava; 并 且 设 置 了 spring.sleuth. 
sampler.percentage 为 1.0， 表 示 百 分 之 百 采 样 ， 这 个 配置 项 的 默认 值 是 0.1， 表 示 百 分 之 十 采 
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样 ， 可 以 根据 需要 设置 不 同 的 值 ， 实 现 不 同比 例 的 采样 率 。 
(3) 页 面 展 示 
访问 Zipkin 服务 的 地 址 ， 可 以 看 到 如 图 9-37 所 示 页 面 。 


服务 名 all BEA all v | 开始 时 间 04-16-2018 10:57 | 


结束 时 间 04-23-2018 10:57 持续 时 间 (us) >= 数量 10 =m o0 
Showing: 0 of 0 排序 : | 耗 时 最 长 优先 T 
Services: 


MARRS. 


图 9-37 Zipkin 页 面 
在 页 面 中 ， 可 以 根据 提示 输入 不 同 的 搜索 条 件 ， 进 行 链 路 跟踪 的 查看 。 服 务 名 是 指 链 路 记 
录 的 服务 ; 跨度 名 是 指 不 同 的 请 求 记录 ; 可 以 设置 时 间 区 间 进 行 搜索 ，Annotations Query 可 以 
设置 更 详细 的 过 滤 条 件 ; 持续 时 间 可 以 设置 请 求 耗 时 时 间 ， 注 意 这 里 使 用 的 时 间 单 位 是 微 秒 而 
不 是 毫秒 ;数量 设置 查询 输出 结果 的 个 数 ， 排 序 可 以 选择 按 最 耗 时 排序 或 者 按照 时 间 排 序 等 。 

请 求 几 次 Consumer 服务 ， 点 击 查找 可 以 查询 Zipkin 记录 的 链 路 跟踪 情况 。 如 图 9-38 所 示 。 


T 


服务 名 | service-consumer + | 跨度 名 | all v | 开始 时 间 04-16-2018 11:09 


结束 时 间 04-23-2018 11:09 持续 时 间 (ys) >= 数量 10 查找 ”© 


Showing: 4 of 4 


Sences 


排序 :| 时 间 倒序 


30.079ms 2 spans 
service-consumer 100% 


Service provider x 10ms 


35.302ms 2 spans 
service-consumer 100% 


Service provider x 19m5 


图 9-38 Zipkin 服务 链 路 记录 


点 击 其 中 一 条 数据 ， 进 入 这 条 数据 的 详情 ， 可 以 看 到 链 路 中 服务 的 耗 时 等 信息 ， 如 图 9-39 
所 示 。 


持续 时 间 : ETD 8s: OQ 法 @ ”span 总 数 : O ED 


全 部 展开 | 全 部 折合 


Services 6.016ms 12.032ms 18.047ms 24.063ms 30.079ms 
国 sevice-consumer | 30.079ms : http:/consumer/7 
service -provider 18.000ms : http:/user/7 


图 9-39 Zipkin 服务 链 路 详情 
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点 击 右上 角 的 JSON 按钮 ， 可 以 看 到 如 下 数据 内 容 。 


[ 
{ 
"traceld": "dd7c3c184a764f2b", 
"id": "dd7c3c184a764f2b", 
"name": "http:/consumer/7", 
"timestamp": 1524452937415000, 
"duration": 30079, 
"annotations": [ 
{ 
"timestamp": 1524452937415000, 
"value": "sr", 
"endpoint": { 
"serviceName": "service-consumer", 
"ipv4": "172.17.238.237", 
"port": 18020 
} 
Ho 
{ 
"timestamp": 1524452937445079, 
"value": "ss", 
"endpoint": { 
"serviceName": "service-consumer", 
"ipv4": "172.17.238.237", 
"port": 18020 
} 
} 
Ib 
"binaryAnnotations": [ 
{ 
"key": "http.host", 
"value": "47.95.113.117", 
"endpoint": { 
"serviceName": "service-consumer", 
"ipv4": "172.17.238.237", 
"port": 18020 
} 
} 
] 
} 
] 


由 于 数据 过 长 ， 所 以 仅 节选 了 其 中 的 部 分 数据 进行 展示 。 还 是 希望 大 家 能 够 亲自 搭建 一 个 
Zipkin 看 一 看 实际 的 数据 内 容 。 那 么 数据 中 记录 的 内 容 主要 在 描述 什么 呢 ? 下 一 节 会 讲解 这 个 
问题 。 


点 击 界面 上 方 的 “依赖 分 析 ”， 可 以 看 到 服务 间 的 依赖 关系 如 图 9-40 所 示 。 
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开始 时 间 04-22-2018 


service-consumer service-provider 


9.6.3 ”数据 解读 


结束 时 间 


04-23-2018 14:12 依赖 分 析 


图 9-40 Zipkin 服务 链 路 依赖 


个 


简单 来 说 ，Zipkin 的 数据 记录 在 


求 链 路 中 ， 某 个 服务 收 到 请 求 ， 发 出 请 求 ， 接 收 应 


Ate Ff E 
答 等 全 量 =e 


图 9-41 可 表示 链 路 中 发 生 的 寻 


件 。 


E 
= 


T =x 
= 
‘Server Received 
Tı 四 = 
“| PER 
Cient Sent 
SERVICE 3 
RESPONSE 
FFH Troe eX 
= z Trace M = X 
CEent Received fone -他 
SERVICE 1 
SERVICE 2 
Trace id = X 
Trace Id = X 
Spent -B 
Cient Received REQUEST > 
Tee wax SERVICE 4 
RESPONSE 
a 
ae 
Server Sent Span id= G 
图 9-41 Zipkin 链 路 事件 


lq 


H 


H, annotations 数据 项 标识 了 Span 记录 的 信 


PA Span 表示 一 个 业务 单元 的 请 求 发 送 与 收 到 应 答 的 完整 事务 ， 在 上 一 节 的 Json 数据 


县， 一 个 Span 中 最 多 记录 4 组 数据 内 容 。 每 组 内 容 


H 


端 应 答 ，cr 标识 客户 端 收 到 应 答 ， 


中 ， 请 求 ; 
到 请 求 并 
Provider 服务 的 返 
在 上 一 节 的 Json 数据 
Zn IP, mO, ERKEK, AH 


9.6.4 通过 消息 中 间 件 收集 信息 
链 路 跟踪 信息 也 可 以 通过 消息 中 间 件 进 
动 的 时 候 也 可 以 通过 消息 中 间 件 记录 下 来 。 
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P value 数据 项 标识 不 同 的 数据 类 型 : cs pris 
这 样 就 形成 了 最 基 而 
一 个 或 者 多 个 Span 组 成 一 个 trace, traceld 是 这 一 次 业务 记录 的 唯一 标识 。 
HA 了 Consumer 服务 ，Consumer 服务 又 调 月 
向 Web 返回 数据 这 一 流程 是 一 个 Span, Consumer 服务 向 Provider 请 求 并 且 收 到 
回 这 一 流程 也 是 一 个 Span， 这 两 个 Span 组 成 了 一 个 trace. 

H, binaryAnnotations 数据 项 记录 了 一 些 其 他 辅助 信息 ， 例 如 服务 
E 请 求 的 类 名 、 


只 客户 端 请 求 发 出 ，sr 标识 服务 端 收 到 ，ss 标识 服务 
的 业务 单元 。 


上 一 节 的 数据 
H T Provider 服务 ， 所 以 Consumer 服务 收 


方法 等 等 。 


行 收集 ， 这 样 业务 服务 的 跟踪 信息 在 Zipkin 没有 启 


第 9 章 Spring Cloud 


C1) 业务 服务 改造 
在 业务 服务 中 ， 保 留 spring-cloud-starter-sleuth 依赖 ， 删 掉 spring-cloud-sleuth-zipkin 依 
赖 ， 添 加 另外 两 个 依赖 用 来 发 送 跟踪 数据 到 消息 中 间 件 。 


<dependency> 
<groupId>org.springframework.cloud</groupId> 
<artifactId>spring-cloud-starter-sleuth</artifactId> 
</dependency> 
<dependency> 
<groupId>org.springframework.cloud</groupId> 
<artifactId>spring-cloud-sleuth-zipkin-stream</artifactId> 
</dependency> 
<dependency> 
<groupld>org.springframework.cloud</groupId> 
<artifactlId>spring-cloud-starter-stream—rabbit</artifactld> 
</dependency> 


修改 业务 服务 配置 文件 : 


spring: 
rabbitmq: 
host: 172.17.238.238 
port: 5673 
username: guest 
password: guest 
sleuth: 
stream: 
enabled: true 
enabled: true 
rxjava: 
schedulers: 
hook: 
enabled: false 
sampler: 
percentage: 1.0 


配置 中 添加 了 消息 中 间 件 的 地 址 ， 并 且 设 置 了 sleuth 通过 stream 发 送 。 把 本 章 使 用 的 两 个 
业务 服务 部 署 上 线 ， 对 Consumer 请 求 几 次 ， 可 以 在 RabbitMQ 中 看 到 sleuth.sleuth 队列 有 数据 
等 待 处 理 ， 如 图 9-42 所 示 。 这 是 由 于 Zipkin 服务 还 未 改造 为 消息 中 间 件 模式 从 而 无 法 消费 消 


息 。 下 面 修 改 Zipkin 服务 。 
、 CŒ | © 39.106.10.196:1567 
bbRabbit 
Overview Connections Channels Exchanges | Queues | Admin 


Queue sleuth.sleuth 


j 


rt 


Overview 


Queued messages 


Ready 13 


Unacked 0 


Total 13 


图 9-42 消息 中 间 件 收集 链 路 信息 
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(2) Zipkin 服务 改造 
修改 Zipkin 服务 的 依赖 ， 去 掉 zipkin-server 依赖 ， 改 为 如 下 依赖 : 


<dependency> 
<groupId>org.springframework.cloud</groupId> 
<artifactId>spring-cloud-sleuth-zipkin-stream</artifactId> 

</dependency> 

<dependency> 
<groupId>org.springframework.cloud</groupId> 
<artifactId>spring-cloud-starter-stream-rabbit</artifactId> 

</dependency> 

<dependency> 
<groupId>io.zipkin.java</groupId> 
<artifactId>zipkin-autoconfigure-ui</artifactId> 

</dependency> 


修改 启动 类 注解 ， 去 掉 @EnableZipkinServer 注解 ， 添 加 @EnableZipkinStreamServer 注解 。 
在 配置 文件 中 添加 消息 中 间 件 配置 项 ， 
Spring: 
rabbitmq: 
host: 172.17.238.238 
port: 5673 
username: guest 
password: guest 
sleuth: 
enabled: false 


之 后 ， 把 Zipkin 服务 重新 部 署 ， 观 察 消 息 中 间 件 的 变化 ， 如 图 9-43 所 示 。 可 见 Zipkin 服 
务 启 动 后 ， 即 处 理 了 消息 中 间 件 中 的 数据 。 


€ > G [O 39.106.10.196:15673/#/queues/%2F 
bbRabbit 


Overview Connections Channels Exchanges Admin 


Queue sleuth.sleuth 
Overview 


Queued messages 


15 


Ready 0 
10 
5 Unacked 0 
0 
12:31:3012:31:4012:31:5012:32:0012:32:1012:32:20 Total m0 
Message rates (chart: last 
3.0/s A publish 0.00/s Consumer 国 0.00/s 
2.0/s ack a 
1.0/5 Deliver 
0.0/5 (manual 0.00/s Redelivered W 0.00/s 
C 12:31:302:31:4012:31:5012:32:0012:32:1 ack) 
Get 
Deliver (manual W 0.00/s 
1 E 0.00/ i> x 
(auto ack) ).00/s ack) 
Get (auto fit 
ack) 0.00/s 


图 9-43 ”消息 中 间 件 数据 被 消费 
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x a 


OR 


9.6.5 ”数据 保存 


时 间 内 的 跟踪 数据 ， 而 不 是 Zipkin 服务 重启 后 数据 就 全 部 丢失 了 。 在 这 个 前 提 


Spring Cloud 


虽然 Zipkin 的 数据 不 像 业 务 服务 数据 一 样 需 要 永久 保存 ， 但 是 有 时 确实 希望 能 够 保留 一 


F, HJ 以 使 | 


MySQL 或 ElasticSearchS 两 种 存储 组 件 。Zipkin 的 存储 配置 相对 简单 ， 只 要 准备 好 相应 存储 组 


并 且 进 行 如 下 配置 即 可 完成 Zipkin 数据 的 存储 。 
(1) MySQL 存储 
在 Zipkin 服务 中 添加 如 下 依赖 : 


<dependency> 
<groupId>mysql</groupId> 
<artifactId>mysql-connector-java</artifactId> 
<scope>runtime</scope> 

</dependency> 

<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-jdbc</artifactId> 

</dependency> 


在 配置 文件 中 添加 如 下 本 


Spring: 


中 


cu 


datasource: 
schema: classpath:/mysql.sql 
driver-class-name: com.mysql.jdbc.Driver 
url: jdbc:mysql://172.17.238.238:3306/springcloudzipkin 
username: root 
password: mypass 
initialize: true 
continue-on-error: true 

zipkin: 

storage: 

type: mysql 


在 对 应 的 MySQL 中 建立 springcloudzipkin 数据 库 。 
经 过 以 上 几 步 ， 就 完成 了 Zipkin 的 MySQL 数据 库存 储 。 
(2) ElasticSearch 存储 


ElasticSearch， 和 否则 Zipkin 无 法 收集 链 路 信息 。 


<dependency> 
<groupld>io.zipkin.java</groupId> 
<artifactld>zipkin-autoconfigure-storage-elasticsearch—http</artifactld> 
<version>1.24.0</version> 
<optional>true</optional> 

</dependency> 


在 配置 文件 中 添加 如 下 本 
Zipkin: 


cu 


© ElasticSearch 是 一 个 分 布 式 的 、 基 于 RESTful 接口 的 搜索 和 分 析 引 擎 。 
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在 Zipkin 服务 中 添加 如 下 依赖 ， 这 里 需要 注意 的 是 引入 的 依赖 版 本 号 要 能 适 配 
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Storage: 

type: elasticsearch 

elasticsearch: 
cluster: elasticsearch 
hosts: http://172.17.238.238:9200 
index: zipkin 
index-shards: 5 
index-teplicas: 1 


经 过 如 上 配置 ， 即 完成 了 Zipkin 通过 ElasticSearch 存储 。 
至 此 ， 本 章 已 经 完成 了 Spring Cloud 大 部 分 组 件 的 讲解 。 下 面 查看 Eureka WM, KEA 
个 服务 集群 的 运行 情况 ， 如 图 9-44 所 示 ， 一 个 健全 的 集群 系统 已 经 搭建 好 了 。 


© |© 47.95.113.117:1800 


© spring Eureka HOME LAST1000 SINCE STARTUP 


System Status 


E 2018-05-11T11:07:18 +0800 


Data default 3 days 17:11 


15 


18 


DS Replicas 


Instances currently registered with Eureka 


Application AMis Availability Zones Status 
CONFIG-SERVER n/a (1) @ 
EUREKA-SERVER n/a (2) 2) 
SERVICE-CONSUMER n/a (1) a 
SERVICE-PROVIDER n/a (2) (2) 
TURBINE n/a (1) o 
ZIPKIN-SERVER n/a (1) (ay 
ZUUL nya (1) a) 


图 9-44 Spring Cloud 服务 集 


oy 
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第 三 篇 组 件 篇 


前 面 的 章节 已 经 接触 了 部 分 系统 组 件 @9， 例 如 在 项 目 中 整合 了 MyBatis， 继 而 使 用 了 
MySQL 数据 库 ; 整合 了 Logback， 从 而 使 服务 可 以 打印 日 志 。 这 些 系统 组 件 的 使 用 在 项 目 中 是 
必 不 可 少 的 。 不 同 的 系统 组 件 提供 了 不 同 的 能 力 ， 所 以 在 程序 设计 阶段 ， 需 要 根据 项 目 需求 选 
择 相应 的 系统 组 件 。 

本 篇 将 首先 介绍 MySQL 数据 库 ， 包 含 操作 数据 库 的 语言 、MyBatis 的 整合 及 自 定义 的 
语句 、 事 务 、 数 据 库 的 优化 等 内 容 。 和 希望 通过 以 上 内 容 的 讲解 ， 能 让 读者 对 数据 库 有 更 深层 
的 认识 。 

继 MySQL 之 后 ， 将 介绍 两 种 不 同 的 NoSQL 存储 ， 分 别 是 MongoDB 和 Redis。 这 两 种 
NoSQL 的 存储 方式 主要 是 针对 MySQL 在 某 些 场景 下 无 法 充分 满足 业务 需求 而 设计 的 ， 例 如 快 
速 存 取 、 大 量 文本 保存 等 。 这 两 种 NoSQL 存储 方式 虽然 不 能 替代 MySQL， 但 是 在 自己 擅长 的 
领域 表现 良好 。 

在 业务 中 ， 除 了 存储 ， 还 有 一 些 需求 需要 其 他 的 组 件 来 实现 ， 例 如 保存 系统 配置 和 实现 注 
册 中 心 ， 这 里 就 会 用 到 Zookeeper; 为 了 满足 文件 存储 的 能 力 ， 就 会 用 到 FastDFS; 为 了 在 平台 
内 实现 快速 的 搜索 ， 会 用 到 ElasticSearch; 为 了 让 平台 能 够 定时 执行 某 些 任务 ， 会 用 到 分 布 式 定 
时 任务 ElasticJob; 为 了 在 平台 内 实现 不 同 服务 的 解 耦 或 者 降低 服务 压力 的 目的 ， 对 某 些 实时 性 
要 求 不 高 的 业务 可 以 使 用 消息 队列 ， 本 篇 会 介绍 RabbitMQ 作为 消息 队列 的 用 法 。 本 篇 的 最 后 ， 
会 介绍 一 种 日 志 管理 方式 ， 可 以 方便 地 汇总 、 查 询 和 统计 日 志 情 况 ， 这 就 是 ELK。 

希望 读者 通过 本 篇 的 学 习 ， 能 够 了 解 相关 组 件 的 特性 和 基本 用 法 ， 并 且 可 以 在 实际 业务 中 
选择 性 地 使 用 合适 的 业务 组 件 。 


O 由 于 本 篇 介绍 的 内 容 较 多 且 较 难 归 类 ， 并 且 本 篇 所 介绍 的 内 容 都 是 为 了 满足 或 者 扩充 系统 程序 的 某 些 能 力 ， 所 以 把 本 篇 介绍 的 
内 容 统称 为 系统 组 件 。 


第 10 章 MySQL 


常见 的 数据 库 种 类 很 多 ， 例 如 Oracle, MySQL. SQL Server 等 ， 各 有 特点 和 应 用 范 


~ 


点 
草 


10.1 


其 中 MySQL 由 于 支持 多 语言 开发 、 成 本 低 、 可 定制 、 社 区 活跃 度 高 、 开 放 源 码 等 特 
点 ， 成 为 许多 项 目的 首选 。MySQL 是 一 个 多 用 户 、 多 线程 的 关系 型 数据 库 管理 系统 ， 本 
将 讲解 MySQL 的 特性 、 命 令 及 用 法 。 


MySQL 基本 介绍 和 使 用 场景 


业务 开发 中 ， 常 用 数据 库存 储 业务 数据 。 那 么 什么 是 数据 库 呢 ?数据 库 (Database〉 是 按照 
数据 结构 来 组 织 、 存 储 和 管理 数据 的 软件 ， 每 个 数据 库 都 有 一 个 或 多 个 不 同 的 API 接口 用 于 创 


10.1.1 


建 、 访 问 、 管 理 、 搜索 和 复制 所 保存 的 数据 。 而 MySQL 是 常用 的 数据 库 产品 之 一 。 


MySQL 概述 


MySQL 是 一 种 关系 型 数据 库 管 理 系统 ， 将 数据 保存 在 不 同 的 表 中 ， 而 不 是 将 所 有 数据 放 在 
一 个 大 表 内 ， 这 样 就 加 快 了 存 取 速度 并 提高 了 灵活 性 。MySQL 的 特点 有 : 


10.1.2 


开源 免费 ， 采 用 了 GPL 协议 ， 可 以 修改 源码 适应 自己 的 系统 。 
可 以 处 理 有 上 千 万 条 记录 的 大 型 数据 。 

可 移植 性 高 ， 安 装 简单 方便 。 
支持 常见 的 SQL 语句 规范 ， 使 用 标准 的 SQL 数据 语言 形式 。 
良好 的 运行 效率 。 

调试 、 管 理 、 优 化 简单 。 


MySQL 常用 存储 引擎 


数据 库存 储 引 擎 是 数据 库 底 层 软件 组 织 。 不 同 的 存储 引擎 提 供 不 同 的 存储 机 制 、 索 引 技 
巧 、 锁 定 水 平等 功能 ， 可 针对 不 同 的 业务 场景 使 用 不 同 的 存储 引擎。 这 里 介绍 常用 的 两 种 存储 


引擎 MyISAM 与 InnoDB. 
InnoDB 和 MyISAM 是 使 用 MySQL 时 最 常用 
体 应 用 场景 而 定 。 


两 个 存储 引擎 ， 这 两 个 引擎 各 有 优 劣 ， 视 具 


rea 


MyISAM 类 型 的 表 强 调 的 是 性 能 ， 其 执行 速度 比 InnoDB KHR, (LAGE SCH 


而 InnoDB 提供 事务 支持 以 及 外 部 键 等 高 级 数据 库 功 能 。 
上 面 的 差别 可 以 看 出 ，InnoDB 更 适合 作为 生产 环境 中 的 事务 处 理 ， 而 MyISAM 更 适合 
作为 ROLAP 〈 关 系 型 联机 分 析 处 理 ) 型 数据 仓库 。 


从 


10.1.3 


MySQL 使 用 场景 


MySQL 应 用 场景 有 以 下 几 种 : 
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C1) Web 应 用 系统 
MySQL 可 应 用 在 站 点 数据 管理 ， 因 为 MySQL 数据 库 安装 配置 简单 ， 而 且 性 能 出 色 。 还 有 
一 个 非常 重要 的 原因 ，MySQL 是 开放 源 代码 的 ， 完 全 可 以 免费 使 用 ， 常 用 于 电 商 系统 、 博 客 系 
统 、 企 业 管理 系统 等 。 
(2) 日 志 系统 
对 需要 大 量 插入 和 查询 日 志 记 录 的 系统 来 说 ，MySQL 是 非常 不 错 的 选择 。 在 使 用 
MyISAM 存储 引擎 的 时 候 ，MySQL 数据 库 的 插入 和 查询 性 能 都 非常 高 效 ， 如 果 设 计较 好 ， 
两 者 可 以 做 到 互 不 锁定 ， 达 到 很 高 的 并 发 性 能 。 例 如 处 理 用 户 相 关 的 操作 日 志 等 。 
(3) 数据 仓库 系统 
随 着 数据 仓库 数据 量 的 飞速 增长 ， 需 要 的 存储 空间 越 来 越 大 。 有 几 个 主要 的 解决 思路 。 
个 是 采用 昂贵 的 高 性 能 主机 以 提高 计算 性 能 ， 用 高 端 存 储 设备 提高 IO 性 能 ， 效 果 理 想 ， 
但 是 成 本 非常 高 ， 例 如 使 用 Oracle。 男 一 个 是 通过 将 数据 水 平 拆 分 ， 使 用 多 台 廉 价 的 计算 机 
安装 MySQL 存放 数据 ， 每 台 计 算 机 上 面 只 存放 一 部 分 数据 ， 解 决 了 数据 量 的 问题 ， 所 有 计 
算 机 并 行 计 算 ， 解 决 了 计算 能 力 问题 ， 通 过 中 间 代 理 程 序 调配 各 台 计 算 机 的 运算 任务 ， 既 可 
以 解决 计算 性 能 问题 又 可 以 解决 IO 性 能 问题 。 所 以 MySQL 也 是 一 个 不 错 的 选择 。 
(4) BARAK 
RARDIN ERARA NT De ll AE AS BL, ERARE T, RPP ASE 
必须 是 轻 量 级 、 低 消耗 的 软件 。MySQL 在 资源 使 用 方面 的 伸缩 性 非常 大 ， 对 组 入 式 环境 
来 说 ， 是 一 种 非常 合适 的 数据 库 系统 ， 而 且 MySQL 有 专门 针对 组 入 式 环境 的 版 本 。 


~ 


也 


10.2 MySQL 基本 操作 
本 书 重点 不 在 MySQL 环境 的 安装 。MySQL 软件 环境 采用 Docker 容器 部 署 ， 具 体 部 署 命 


令 参 照 第 19 章 的 内 容 。 
SQL 语言 共 分 为 四 大 类 : 数据 定义 语言 DDL， 数 据 查 询 语言 DQL， 数 据 操 纵 语言 DML, 
数据 控制 语言 DCL。 接 下 来 介绍 这 四 部 分 语言 如 何在 MySQL 环境 下 进行 使 用 。 
10.2.1 MySQL 创建 和 删除 数据 库 
MySQL 需 使 用 create 命令 创建 数据 库 ， 语 法 如 下 : 
CREATE DATABASE < 数据 库 名 >; 
用 drop 命令 删除 数据 库 : 
DROP DATABASE < 数据 库 名 >; 
在 删除 数据 库 过 程 中 ， 务 必 谨 慎 ， 因 为 在 执行 删除 命令 后 ， 所 有 数据 将 会 清除 。 
10.2.2 DDL 基本 操作 


数据 定义 语言 (DDL) 用 来 创建 数据 库 中 的 各 种 对 象 ( 表 、 视 图 等 )。 
在 介绍 表 之 前 ， 先 了 解 一 下 MySQL 的 数据 类 型 ， 数字、 日 期 /时 间 、 字 符 串 、 空 间 坐标 
等 。 这 几 个 类 型 又 更 细致 地 划分 了 许多 子 类 型 ， 见 表 10-1。 


> 
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表 10-1 数据 类 型 


数据 类 型 具体 子 类 型 


浮 点 数 : float、double、real、decimal 


整数 : tinyint、smallint、mediumint、int、bigint 


期 和 时 间 date. time, datetime. timestamp. year 


mf 


字符 串 : char, varchar 
文本 : tinytext、text、mediumtext、longtext 


- 进 制 (可 用 来 存储 图 片 、 音 乐 等 tinyblob、blob、 


mediumblob、longblob 


空间 类 型 Geometry, Point, Curve, LineString, MultiPoint 等 


(1) MySQL 表 创 建 


数据 库 表 的 信息 包括 表 名 、 表 字段 以 及 各 个 字段 的 类 型 。 


创建 MySQL 数据 表 的 SQL 通用 格式 : 
CREATE TABLE table_name (column name column type); 
例如 创建 商品 表 product 的 SQL 语句 如 下 : 


CREATE TABLE ‘product’ ( 

‘id’ int(11) NOT NULL AUTO_INCREMENT , 
‘product_name* varchar(150) CHARACTER , 
‘price’ int(11) NULL DEFAULT NULL, 
‘product_desc’ varchar(500), 

‘product pic varchar(255), 

PRIMARY KEY (‘id’) 

) ENGINE=InnoDB DEFAULT CHARSET=1tf; 


E AUTO INCREMENT 是 定义 此 列 为 自 增 的 属性 ， 一 般 用 于 主键 ， 数 值 会 自动 加 1. 


E PRIMARY KEY 关键 字 用 于 定义 列 为 主键 。 也 可 使 用 多 列 来 定义 主键 ， 列 间 以 逗号 


分 隔 。 


国 表 中 某 些 字段 可 以 为 NULL， 也 可 以 设置 字段 不 能 为 空 (如 NOT NULL)， 对 于 设置 
能 为 空 的 字段 ， 若 在 操作 数据 库 时 赋值 为 NULL， 就 会 报错 。 


m 
> 


E ENGINE 设置 存储 引擎 ， 本 节 使 用 InnoDB; CHARSET 设置 编码 ， 常 用 utf8。 


(2) MySQL 表 的 修改 删除 


当 需 要 修改 数据 表 名 或 表 字 段 时 ， 就 需要 使 用 MySQL 的 ALTER 命令 。 例 如 要 将 商品 表 
product 的 product_desc 字段 大 小 改 成 varchar(400)， 使 用 MODIFY 关键 字 ， 具 体操 作 如 下 : 


ALTER TABLE product MODIFY product desc varchar(400); 


修改 字段 名 称 使 用 CHANGE 关键 字 ， 例 如 将 商品 表 中 的 product dese 字段 修改 名 称 为 


product_ desc01， 字 段 类 型 长 度 不 变 ; 


ALTER TABLE product CHANGE product desc product desc01 varchar(400); 


(3) MySQL 修改 表 名 


如 需 修改 表 的 名 称 ， 可 以 在 ALTER TABLE 语句 中 使 


ALTER TABLE < 原 表 名 > RENAME TO < 新 表 名 >; 
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10.2.3 DQL 基本 操作 
数据 查询 语言 (DQL) 基 本 结构 由 SELECT FAJ FROM FJ, WHERE 子 句 组 成 。 
(1) MySQL 数据 库 中 查询 数据 通用 的 SELECT 语法 : 


SELECT column_name,column_name 
FROM table_name 


[WHERE Clause] 
[LIMIT N][ OFFSET M] 
E SELECT: 可 以 读 取 一 条 或 者 多 条 记录 。 不 指定 列 名 而 使 用 星 号 C), SELECT 语句 会 
返回 表 的 所 有 字段 数据 。 


zl 


E From: 可 使 用 一 个 或 多 个 表 ， 用 去 号 〈,) 分 隔 。 
m WHERE: 设置 查询 条 件 。 
E LIMIT: 设 定 返回 的 记录 数 ， 例 如 limit mn 其 中 m 是 指 记录 开始 的 index，n 是 指 从 第 
mH 条 开始 ， 取 mn 条。 

E OFFSET: 指定 SELECT 语句 开始 查询 的 数据 偏 移 量 。 默 认 情况 下 偏 移 量 为 0。 
(2) WHERE 子 句 常用 语法 如 下 : 

SELECT fieldl, field2...fieldN FROM table namel, table name2... 

[WHERE condition! [AND [OR]] condition2... ] 
WHERE 可 以 使 用 AND 或 者 OR 指定 一 个 或 多 个 条 件 。WHERE 子 句 类 似 于 程序 语言 中 

的 if 条 件 ， 根 据 MySQL 表 中 的 字段 值 来 读 取 指 定 的 数据 。 

例如 查询 商品 价格 在 [100,300] 区 间 的 数据 : 


select * from product where price >=100 and price <=300 


10.2.4 DML 基本 操作 
数据 操纵 语言 (DML) 主要 有 三 种 形式 : 
(1) 插入 : INSERT 
MySQL 数据 表 插 入 数据 使 用 INSERT INTO 语法 : 

INSERT INTO table name (fieldl, field2,...fieldN ) VALUES (valuel, value2,...valueN ); 

例如 在 商品 表 中 插入 一 条 数据 : 


INSERT INTO ‘product’ (idproduct name,price,product desc,product pic) VALUES ('10', java dev map 
Book', '212', ' 商 品 描述 desc’, 'download?filename=javamapdev.png’); 


(2) 更 新 : UPDATE 
UPDATE 命令 是 修改 MySQL 数据 表 数 据 的 常用 语法 : 
UPDATE table name SET field1=newvaluel, field2=newvalue2 [WHERE Clause] 
可 以 同时 更 新 多 个 字段 并 且 在 WHERE 子 句 中 指定 更 新 条 件 。 例 如 更 新 id 为 107 商品 的 商 
品名 称 ， 更 改 为 java dev Version02: 


update product set product_name = 'java dev Version02' where id =107 


(3) 删除 : DELETE 
MySQL 数据 表 中 删除 数据 的 通用 语法 : 
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DELETE FROM table name [WHERE Clause] 


如 果 未 指定 WHERE $F), MySQL 表 中 的 所 有 记录 都 将 被 删除 。 可 以 在 WHERE 子 句 中 
指定 删除 条 件 。 例 如 删除 商品 表 中 id 为 107 的 数据 : 


delete from product where id =107 


10.2.5 DCL 基本 操作 
数据 控制 语言 (DCL) 用 来 授予 或 回收 访问 数据 库 的 某 种 特权 ， 可 以 限制 用 户 访问 哪些 


库 、 哪 些 表 ， 限 制 用 户 对 哪些 表 执 行 SELECT. CREATE, DELETE, UPDATE, ALTER 等 操 
VE; 限制 用 户 登录 的 了 P 或 域名 ;限制 用 户 自己 的 权限 是 否 可 以 授权 给 别 的 用 户 。 


(1) GRANT: 授权 。 
MySQL 赋予 用 户 权限 命令 的 简单 格式 : 
grant 权限 on 数据 库 对 象 to 用 户 
例如 授权 用 户 user01 在 数据 库 Gavadevmap) PÆ product 的 所 有 权限 ， 并 指定 user01 的 登 
录 密 码 为 123456。 具 体 如 下 : 
grant all privileges on javadevmap.product to 'user01'@'%' identified by '123456' with grant option; 
上 述 命令 具体 含义 如 下 : 
E all privileges: 表示 将 所 有 权限 授予 用 户 ; 也 可 指定 具体 的 权限 ， 例 如 SELECT. 
CREATE、DROP 等 。 
Moon: 表示 这 些 权限 对 哪些 数据 库 和 表 生 效 。 格 式 : 数据 库 名 . 表 名 ， 如 果 写 “*” 表 示 所 
有 数据 库 、 所 有 表 。 例 子 中 指定 为 javadevmap 数据 库 的 product 表 。 
to: 将 权限 授予 哪个 用 户 。 格 式 : ' 用 户 名 '@' 登 录 IP 或 者 域名 '。% 表 示 没 有 限制 ， 在 任 
何 主机 都 可 以 登录 。 例 如 : 'user01'@'192.168.3.%'， 表 示 user01 这 个 用 户 只 能 在 
192.168.3 的 IP 段 登录 。 
E identified by: 指定 用 户 的 登录 密码 。 
E with grant option: 表示 人 允许 用 户 将 自己 的 权限 授权 给 其 他 用 户 。 
对 用 户 进行 权限 变更 之 后 ， 需 重新 加 载 权 限 ， 将 权限 信息 从 内 存 中 写 入 数据 库 。 有 具体 操作 


一 并 
~ 


命令 : 
flush privileges; 
查看 当前 用 户 权 限 : 
show grants; 


回收 权限 : 删除 user01 这 个 用 户 的 create 权限 ， 该 用 户 将 不 能 创建 数据 库 和 表 。 


revoke create on *.* from user01@%; 
flush privileges; 


Ww 


(2) ER: ROLLBACK 
ROLLBACK [WORK] TO [SAVEPOINT]: 回 退 到 某 一 点 。 回 滚 命令 使 数据 库 状 态 回 到 上 次 
最 后 提交 的 状态 。 
MySQL 默认 是 打开 了 自动 提交 的 ， 关 闭 自动 提交 有 以 下 方法 : 
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E Session 级 别 : 使 用 START TRANSACTION 或 者 BEGIN 来 开始 一 个 事务 ， 使 用 
ROLLBACK/COMMIT 来 结束 一 个 事务 ; 或 使 用 SET autocommit=0 关闭 当前 session 的 

自动 提交 ， 每 次 提交 需要 手动 COMMIT。 
E 全 局 级 别 : SET GLOBAL autocommit=0 关闭 全 局 的 自动 提交 。 
商品 表 来 演示 ROLLBACK 的 使 用 。 即 删除 id 为 107 的 商品 ， 然 后 执行 ROLLBACK, 
查看 数据 是 否 回 滚 。 具 体操 作 命令 如 下 ; 

select * from product; 

start transaction; 

delete from product where id=107; 

select * from product; 

rollback; 

select * from product; 
操作 结果 如 图 10-1 所 示 。 


elect * from product: 


delete from product 
K, 1 row 


图 10-1 事务 命令 结果 
ROLLBACK 只 能 在 一 个 事务 处 理 内 使 用 (在 执行 一 条 START TRANSACTION 命令 之 
后 )。 分 析 上 面 的 例子 ， 从 查询 product 表 开 始 ， 首 先 执行 一 条 SELECT 语句 查看 表 中 数据 。 然 
后 开始 一 个 事务 处 理 ， 用 一 条 DELETE 语句 删除 id 为 107 的 商品 数据 。 接 下 来 执行 SELECT if 
句 验证 id 为 107 的 记录 被 删除 。 此 时 执行 ROLLBACK 命令 ， 回 退 START TRANSACTION 之 
后 的 所 有 语句 ， 最 后 一 条 SELECT 语句 显示 id 为 107 的 商品 记录 被 恢复 了 。 

(3) 提交 : COMMIT 

MySQL 语句 都 是 直接 针对 数据 库 表 执行 和 编写 的 。 这 就 是 所 谓 的 隐 含 提交 Cimplicit 
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commit)， 即 提交 操作 是 自动 进行 的 。 但 是 ， 在 事务 处 理 块 中 ， 提 交 不 会 隐 含 地 进行 。 为 进行 明 
确 的 提交 ， 需 要 使 用 COMMIT 语句 。 这 里 用 商品 表 和 用 户 举例 ， 实 现 删除 id 为 1 的 用 户 表 记 
录 和 商品 id 为 107 的 商品 表 记 录 ; 如 下 所 示 : 

start transaction; 

delete from user where id =1; 

delete from product where id =107; 

commit; 

上 面 例子 涉及 删除 用 户 表 user 和 商品 表 product 中 的 数据 ， 所 以 使 用 事务 处 理 块 来 保证 业务 

不 被 部 分 删除 〈 一 方 删除 成 功 ， 一 方 未 删除 成 功 )。 最 后 的 COMMIT 语句 仅 在 不 出 错时 生效 。 
如 果 第 一 条 DELETE 语句 起 作用 ， 但 第 二 条 失败 ， 则 第 一 条 DELETE 语句 会 被 自动 撤销 。 


10.3 事务 处 理 


上 一 节 多 少 涉及 了 事务 ， 本 节 学 习 事 务 处 理 。 首 先 了 解 什么 是 数据 库 事务 : 数据 库 事务 
(database transaction) 是 指 作 为 单个 逻辑 工作 单元 执行 的 一 系列 操作 ， 要 么 完全 执行 ， 要 么 完全 


不 执行 。 事 务 处 理 可 以 确保 事务 性 单元 内 的 所 有 操作 都 成 功 完 成 时 才 更 新 面向 数据 的 资源 。 

通俗 理解 ， 在 关系 数据 库 中 ， 一 个 事务 可 以 是 一 条 SQL 语句 ， 一 组 SQL 语句 或 整个 程序 
或 者 理解 为 事务 是 用 来 管理 insert、update、delete 语句 单个 或 组 合 使 用 的 。 例 如 银行 转账 场景 : 
从 一 个 账号 扣 款 并 在 男 一 个 账户 增 款 ， 要 么 都 执行 ， 要 么 都 不 执行 。 


10.3.1 事务 概述 


一 般 来 说 ， 事 务必 须 满足 4 个 条 件 (ACID ): 

m 原子 性 〈Atomicity， 或 称 不 可 分 割 性 ): 一 个 事务 (transaction) 中 的 所 有 操作 ， 要 么 
部 完成 ， 要 么 全 部 不 完成 ， 不 会 结束 在 中 间 某 个 环节 。 事 务 在 执行 过 程 中 发 生 错 误 ， 

滚 (rollback) 到 事务 开始 前 的 状态 ， 就 像 这 个 事务 从 来 没有 执行 过 一 样 。 

m cE (Consistency): 在 事务 开始 之 前 和 事务 结束 以 后 ， 数 据 库 的 完整 性 不 会 被 破坏 。 
这 表示 写 入 的 内 容 必须 完全 符合 所 有 的 预 设 规则 。 

m 也 离 性 〈Isolation， 又 称 独立 性 ): 数据 库 允 许多 个 并 发 事务 同时 对 其 数据 进行 读 写 和 修 
改 的 能 力 ， 隔 离 性 可 以 防止 多 个 事务 并 发 执行 时 由 于 交叉 执行 而 导致 数据 的 不 一 致 。 寻 
务 隔 离 分 为 不 同 级 别 ， 包 括 读 未 提交 (read uncommitted), pE (read committed), PJ 
重复 读 (repeatable read) 和 串 行 化 〈serializable )。 

E 持久 性 (Durability): 事务 处 理 结束 后 ， 对 数据 的 修改 是 永久 的 ， 会 被 持久 化 到 本 地 。 


10.3.2 事务 处 理 方法 


本 节 演 示 的 例子 基于 Spring Boot 整合 MyBatis, MyBatis 整合 进 Spring Boot 工程 的 方法 已 
经 在 前 面 章节 有 详细 的 讲解 ， 不 再 袭 述 。 按 照 之 前 的 方法 新 建 一 个 工程 MysqlExample。 

Spring Boot 项 目 事 务 配 置 步 又 : 

1) 注解 依赖 

需要 的 注解 为 @EnableTransactionManagement 和 人 @Transactional ， 它 们 来 自 spring-tx- 
4.3.14.RELEASE jar 包 ， 该 包 在 配置 MyBatis 依赖 时 ， 通 过 起 步 依赖 mybatis-spring-boot-starter 
已 自动 引入 。 
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2) 业务 类 添加 @Transactional 注解 
@Transactional 注解 如 果 加 在 类 上 ， 则 该 类 所 有 的 方法 都 会 被 事务 管理 ， 如 果 加 在 方法 
上 ， 则 仅 对 该 方法 进行 事务 管理 。 一 般 部 是 加 在 方法 上 ， 因 为 只 有 涉及 增 、 删 、 改 才 会 需要 
事务 。 
在 工程 中 ， 添 加 业务 轴 辑 处 理 类 ProductServiceImpl， 此 类 中 
加 商品 ， 在 此 方法 上 添加 事务 注解 ， 并 指定 REQUIRED 事务 传播 行为 ， 事 务 隔 离 级 别 为 底层 数 
据 库 的 默认 隔离 级 别 ， 事 务 超时 时 间 为 30s， 人 针对 Exception 进行 回 滚 : 
@Service 
public class ProductServiceImp! implements ProductService { 
@Autowired 
ProductDao productDao; 


TH 


| 


包含 addProduct 方法 ， 用 于 添 


@Transactional(propagation = Propagation. REQUIRED, 
isolation = Isolation. DEFAULT, 
timeout = 30, 
rollbackF or = Exception.class) 
@Override 
public void addProduct(String name, int price, String desc) { 
Product product = new Product(); 
product.setPrice(price); 
product.setProductName(name); 
product.setProductDesc(desc); 
productDao.save(product); 


} 
} 
上 面 配 置 @Transactional 注解 时 使 用 了 相关 属性 ， 属 性 含义 见 表 10-2。 
表 10-2 事务 属性 
属 性 类 型 Ho R 
value String 可 选 的 限定 描述 符 ， 指 定 使 用 的 事务 管理 器 
propagation enum:Propagation 可 选 的 事务 传播 行为 设置 
isolation enum:Isolation 可 选 的 事务 隔离 级 别 设置 
readOnly boolean 读 写 或 只 读 事务 ， 默 认 读 写 
timeout int 事务 超时 时 间 设 置 ( 秒 ) 
十 象 数 组 ， 必 须 继 Spe 
rollbackFor Class 对 象 数组 ， 必 须 继承 导致 事务 回 滚 的 异常 类 数组 
Throwable 
rollbackForClassName 类 名 数组 ， 必 须 继承 导致 事务 回 滚 的 异常 类 名 字数 组 
Throwable 
Roba Class 对 象 数 组 ， 必 须 继承 | 该 属性 用 于 设置 不 需要 进行 回 深 的 异常 类 数组 ， 当 方法 中 抛 出 指定 异 
noRollbackFor Throwable 常数 组 中 的 异常 时 ， 不 进行 事务 回 滚 
类 名 数组 ， 必 须 继承 该 属性 用 于 设置 不 需要 进行 回 滚 的 异常 类 名 称 数 组 ， 当 方法 中 抛 出 指 

Sam | Throwable 定 异 常 名 称 数组 中 的 异常 时 ， 不 进行 事务 回 深 

3) 开启 事务 

其 实 目前 的 事务 已 经 是 默认 开启 的 ， 但 是 为 了 标记 此 服务 中 包含 事务 处 理 ， 可 以 在 工程 的 

启动 类 中 添加 注解 @EnableTransactionManagement。 
g 
通过 上 面 的 三 步 ， 即 完成 了 事务 的 配置 。 那 么 配置 事务 与 未 配置 事务 有 什么 区 别 呢 ? 这 里 
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编写 了 两 个 测试 方法 进行 验证 。 即 在 ProductServiceImpl 类 中 添加 两 个 方法 ， 其 执行 内 容 一 致 ， 


不 同 的 地 方 在 于 方法 modifyProductsByTransaction0 添加 了 人 @Transactional 3 fi 
modifyProducts() 示 添加， 在 方法 体 里 面 通过 “inti=4/0;” 语 句 来 抛 出 异常 。 
@Autowired 
ProductDao productDao; 


@Override 
public void modifyProducts() { 


Product product = new Product(); 
product.setPrice(233); 
product.setProductName("java dev map version 02"); 
product.setProductDesc(" 商 品 描述 "); 
productDao.save(product); 


inti= 4/0; 

product = new Product(); 

product.setPrice(800); 
product.setProductName("java dev map version 03"); 
product.setProductDesc(" 商 品 描述 03"); 
productDao.save(product); 


j 


@Transactional(propagation = Propagation. REQUIRED, 
isolation = Isolation. DEFAULT, 
timeout = 30, 
rollbackFor = Exception.class) 
@Override 
public void modifyProductsByTransaction() { 
Product product = new Product(); 
product.setPrice(233); 
product.setProductName("java dev map version 02"); 
product.setProductDesc(" 商 品 描述 "); 
productDao.save(product); 


inti= 4/0; 

product = new Product(); 

product.setPrice(800); 
product.setProductName("java dev map version 03"); 
product setProductDesc(" 商 品 描述 03"); 
productDao.save(product); 


} 
添加 测试 类 ProductMapperTest， 分 别 执行 两 个 方法 。 


@RunWith(SpringRunner.class) 
@SpringBootTest 
public class ProductMapperTest { 

@Autowired 

ProductService productServiceImpl; 

@Test 

public void testTransaction() { 

productServiceImpl.modify Products(); 
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@Test 

public void testTransaction02(){ 
productServiceImplmodifyProductsByTransaction(); 


} 
} 


执行 两 个 测试 方法 时 ， 均 抛 出 了 异常 : 
Java.ang.ArithmeticException: / by zero 

但 是 方法 modifyProducts0 的 第 一 条 数据 仍然 被 持久 化 到 数据 库 中 。 而 添加 了 @Transactional 
的 方法 modifyProductsByTransaction0 执 行 后 ， 两 条 记录 都 没有 被 持久 化 到 数据 库 中 。 可 见 
@Transactional 作用 可 以 保证 事务 的 原子 性 。 


10.4 MyBatis 插入 获取 主键 


业务 开发 时 ， 有 时 候 搬入 一 条 数据 ， 需 要 立刻 得 到 搬入 数据 的 id， 例 如 插入 一 条 商品 
据 ， 然 后 将 插入 成 功 的 id 返回 给 前 端 。 但 是 自动 生成 的 mapper 中 的 insert 方法 ， 默 认 是 不 会 返 
回 主 键 的 。 这 里 使 用 如 下 方法 来 演示 如 何 实现 插入 数据 后 返回 主键 id。 


新 建 自 定义 Mapper 类 ProductManualMapper， 添 加 如 下 内 容 : 


public interface ProductManualMapper { 
Integer insertProduct(@Param("pro") Product product); 


Duj 


} 
在 项 目的 resources/mybatis/manual 文件 夹 下 面 新 建 ProductManualMapperxmlS 文 件 ， 在 此 
文件 中 添加 如 下 内 容 : 
<?xml version="1.0" encoding="UTF-8"?> 
<!DOCTYPE mapper 
PUBLIC "~//mybatis.org//DTD Mapper 3.0//EN" 


"http://mybatis.org/dtd/mybatis-3—mapper.dtd"> 
<mapper namespace="com.javadevmap.mysqlexample.mapper.ProductManualMapper"> 


<insert id="insertProduct" parameterType="Product"> 

<selectKey resultType="java.lang.Integer" keyProperty="pro.id" order="AFTER" > 
SELECT LAST INSERT IDO 

</selectKey> 
INSERT INTO 
product(product_name, price, product_desc) 
VALUES ( 
#{pro.productName}, 
#{pro.price}, 
#{pro.productDesc} 
) 

</insert> 

</mapper> 


yy >. 


<insert></insert> 标签 中 没有 resultType 属性 ， 但 <selectKey></selectKey> 标 签 是 有 的 。 通 过 


© 生成 此 文件 后 ， 记 得 检查 工程 的 application.yml 文件 ， 查 看 mybatis 属性 项 是 否 添加 了 对 此 文件 的 扫描 。 
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设置 <selectKey> 中 order 的 属性 值 ， 即 order="AFTER"， 使 其 先 执行 插入 语句 ， 再 执行 查询 语 
句 。keyProperty="pro.id" 表 示 将 自 增长 后 的 Id 赋值 给 实体 类 中 用 @Param 注解 标注 为 “pro” 
的 类 实例 字段 。 如 果 没 有 添加 @Param 注解 指定 类 实例 名 ， 那 么 <insert> 标 签 中 的 pro 名 字 要 
去 掉 。 
selectKey 标签 属性 和 含义 见 表 10-3. 


表 10-3 selectKey 标签 属性 和 含义 


属性 名 作 
resultType 执行 SQL 语句 后 的 返回 数据 类 型 
order 执行 SQL 的 顺序 ，AFTER 表示 先 执行 插入 语句 ， 之 后 再 执行 查询 语句 
keyProperty keyProperty 是 Java 对 象 的 属性 名 


TT 


在 DAO 中 注入 自 定义 Mapper， 并 且 添 加 保存 方法 : 


public interface ProductDao { 
int save(Product product); 


} 


@Repository 

public class ProductDaoImp! implements ProductDao { 
@Autowired 
ProductManualMapper productManualMapper; 


@Override 
public int saveProduct(Product product) { 
return productManualMapper.insertProduct(product); 
} 
j 


编写 测试 代码 ， 有 具体 如 下 : 


@Autowired 

private ProductDao productDao; 

@Test 

public void testGetInsertDataldQ) { 
Product product = new Product(); 
product.setPrice(2332); 
product.setProductName("java dev map " + System.currentTimeMillis()); 
product setProductDesc(" 商 品 描述 dao save "); 
Integer num = productDao.save(product); 
System.out.println(product); 
System.out.printin("insertProductld: " + product.getId()); 


} 
运行 结果 如 下 : 
Product [Hash = 1029790510, id=146, productName=java dev map 1526027394815, price=2332, 


productDesc= 商 品 描述 dao save, productPic=null, serial VersionUID=1 ] 
insertProductld: 146 


通过 上 面 的 运行 结果 可 以 看 到 程序 返回 了 插入 商品 的 ido 
当然 如 果 使 用 的 是 Maven 的 mybatis-generator-maven-plugin 插件 ， 可 以 配置 generateKey 
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性 ， 让 插件 在 自动 生成 Insert Mapper 语句 时 ， 生 成 一 条 正确 的 selectKey 元 素 。 在 


generatorConfig.xml 配置 table 标签 时 添加 < generatedKey > 元 素 ， 


<generatorConfiguration> 


aS 


LAC ELON F: 


<table tableName="product"> 


<property name= 


<!-- 数据 库 表 3 


m. 


useActualColumnNames" value="false" /> 


ER => 


<generatedKey column="id" sqlStatement="Mysql" identity="true" /> 


</table> 
</context> 
</generatorConfiguration> 


当 执 行 生 成 命令 mybatis-generator:generate 后 ， 就 会 发 现 Product 对 应 的 Mapper 文件 已 经 
在 <insert> 标 签 内 生成 了 返回 主键 的 <selectKey> 标 签 元 素 。 建 议 使 用 此 方法 ， 因 为 手写 <insert> 毕 
TAR, M HAA A 
10.5 MyBatis 多 表 查 询 

MyBatis 自动 生成 单 表 的 增删 改 查 功能 给 开发 带 来 了 很 多 的 便利 ， 但 是 有 时 候 需 求 会 涉及 


关联 查询 ， 这 是 
t_order 表 。 
(1) 定义 返回 实体 Bean 


X — WAKA 


ra 
EYER ZN 


J 


新 建 一 个 OrderAndProductModel 类 ， 


含有 


< ， 即 每 个 订 个 产品 id， 需 要 连接 product 表 和 


MAUI F: 


package com.javadevmap.mysqlexample.model; 


import java.io.Serializable; 


/** 
* 订单 与 商品 bean 
a 


public class OrderAndProductM 
private String orderName; 
private Integer id; 


odel implements Serializable { 


private String productName; 


private Integer price; 
private String productDesc; 
private String productPic; 


//... 省 略 get 与 set 方法 
@Override 
public String toString() { 


return "OrderAndProductModel {" + 


"orderName 


=" + orderName + '\" + 


y id=" +id+ 


", productName: 


", price=" + 


+ productName + '\" + 
price + 


", productDesc=" + productDese + '\" + 


" 
2 


5 


productPic=" + productPic + '\" + 
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} 
(2) 定义 Mapper 文件 
在 项 目的 ProductManualMapperxml 文件 中 ， 添 加 内 容 ， 定 义 两 个 表 的 查询 语句 ， 有 具体 
如 下 : 


<mapper namespace="com.javadevmap.mysqlexample.mapper.ProductManual Mapper"> 
<resultMap id="BaseResultMap" 
type="com.javadevmap.mysqlexample.model.OrderAndProductModel" > 

<id column="id" property="id" jdbcType="INTEGER" /> 

<result column="name" property="orderName" jdbcType="VARCHAR" /> 

<result column="product_name" property="productName" jdbcType="VARCHAR" /> 

<result column="price" property="price" jdbcType="INTEGER" /> 

<result column="product_desc" property="productDesc" jdbcType="VARCHAR" /> 

<result column="product_pic" property="productPic" jdbcType="VARCHAR" /> 
</resultMap> 


<select id="getOrderProductList" resultMap="BaseResultMap"> 
select pro.id, pro.product_name,pro.price,pro.product_desc,ord.name 
from product pro,t_order ord where pro.id=ord.product_id; 
</select> 
</mapper> 


Mapper 文件 中 定义 了 与 实体 OrderAndProductModel 映射 的 resultMap 结果 集 ， 同 时 增加 了 
一 个 select 的 查询 语句 。 

(3) 定义 数据 操作 

在 ProductManualMapper 类 中 增加 一 个 方法 getOrderProductList()， 方 法 名 与 mapper 文件 中 
的 select id 一 致 ， 具 体 如 下 : 


public interface ProductManualMapper { 


List<OrderAndProductModel> getOrderProductList(); 
} 


编写 测试 类 ProductMapperTest， 测 试 定 义 的 getOrderProductList 方法 ， 具 体 如 下 : 


@RunWith(SpringRunner.class) 
@SpringBootTest 
public class ProductMapperTest { 
@Autowired 
private ProductManualMapper productManualMapper; 
List<OrderAndProductModel> orderProductList=null; 
@Test 
public void testSelfMapper() { 
orderProductList = productManualMapper.getOrderProductList(); 
System.out.printIn("result size() = " + orderProductList.size()); 
if (orderProductList.size() > 0) { 
for (OrderAndProductModel item : orderProductList) { 
System.out.println(item); 


j 
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result size() = 2 
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OrderAndProductModel {orderName='order01', id=108, productName='java dev map version 02 update’, 


price=34, productDesc="null', productPic='null'} 


OrderAndProductModel {orderName='order02', id=109, productName='java dev map version 02', price=233, 


productDesc=' 商 品 描述 , productPic—'null'} 


10.6 ”查询 优化 


业务 应 用 的 访问 性 能 由 多 方面 因素 决定 。 数 据 库 MySQL 是 业务 应 用 的 组 成 部 分 ， 也 是 决 
定 其 性 能 的 重要 部 分 。 所 以 提升 MySQL 的 性 能 至 关 重 要 。MySQL 性 能 的 提升 可 分 为 三 部 分 ， 
包括 人 硬件、 网 络 、 软 件 。 其 中 硬件 、 网 络 取决 于 公司 


的 硬件 设备 以 及 网 络 带 宽 。 软 件 部 分 又 分 很 多 种 ， 


进行 性 能 的 提升 。 
10.6.1 优化 查询 的 方向 


首先 需要 了 解 MySQL 服务 器 状态 信息 ， 例 


本 


WHET MySQL 软件 层面 的 优化 ， 从 查询 优化 入 手 


如 


MySQL 启动 后 的 运行 时 间 ，MySQL 的 客户 端 会 话 连 
HM, 服务器 执行 的 慢 查 询 数 ,执行 了 多 少 
SELECT/UPDATE/DELETE/INSERT 语句 等 统计 信 
息 ， 以 便 根据 当前 MySQL 服务 器 的 运行 状态 进行 相 


应 的 调整 或 优化 。 


信息 ， 如 图 10-2 所 示 。 


使 用 show status 指令 查看 MySQL 服务 器 的 状态 


执行 show status 语句 后 ，MySQL 将 会 列 出 多 达 
340 条 的 状态 信息 记录 ， 为 了 快速 实现 优化 需要 特别 


关注 Slow_queries 〈 慢 查询 次 数 )、Com (CRUD) 
作 的 次 数 、Uptime( 上 线 时 间 ) 等 几 个 重要 信息 。 


操 


加 查看 查询 时 间 超 过 long query time 秒 的 查询 


的 个 数 : 


show global status like 'slow_queries'; 


图 查看 select 语句 的 执行 数 : 
show global status like 'com select'; 
图 查看 insert 语句 的 执行 数 : 
how global status like 'com insert'; 


加 查看 update 语句 的 执行 数 : 
show global status like 'com_update'; 


n 


Variable_name 
> Aborted clients 
Aborted_connects 


Binlog_cache_disk_use 


Binlog_cache_use 


Binlog_stmt_cache_disk_u: 
Binlog_stmt_cache_use 
Bytes_received 
Bytes_sent 
Com_admin_commands 
Com_assign_to_keycache 
Com_alter_db 

Com alter db upgrade 
Com_alter_event 
Com_alter_function 
Com_alter_procedure 


Com_alter_server 


Com_alter_table 


110-2 MySQL 状态 信息 
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图 查看 delete 语句 的 执行 数 : 
show global status like 'com_delete'; 
m 查询 当前 MySQL 本 次 启动 后 的 运行 统计 时 间 CRD): 
show global status like 'uptime'; 
通过 上 面 的 常用 MySQL 指令， 能够 清楚 地 了 解 当前 MySQL 是 否 存在 问题 ， 以 及 问题 分 布 
在 哪里 。 接 下 来 针对 出 现 的 问题 着 手 优 化 。 
10.6.2 EXPLAIN 分 析 
在 日 常 工作 中 ， 可 以 通过 开启 慢 碍 询 记录 一 些 执行 时 间 比 较 和 久 的 SQL 语句， 设置 的 具体 步 
又 如 下 : 
1) 将 slow_query log 全 局 变量 设置 为 “ON” 状 态 。 
set global slow_query_log='ON'; 
2) 设置 慢 碍 询 日 志 存放 的 位 置 。 
set global slow query log file='/var/log/mysql/slow.log'© 
3) 设置 查询 超过 4s 就 记录 。 
set global long _query_time=4; 
通过 上 面 设置 ， 在 log 文件 中 记录 了 超过 4s 的 SQL 语句 ， 可 以 用 explain 命令 来 查看 这 些 
SQL 语句 的 执行 计划 ， 查 看 SQL 语句 有 没有 使 用 索引 ， 有 没有 全 表 扫 描 。 例 如 查看 查询 商品 语 
句 的 执行 计划 : 
EXPLAIN SELECT * FROM product 
执行 结果 如 图 10-3 所 示 。 


EXPLAIN select * 


信息 结果 1 ”概况 ”状态 
id select_type table type possible_keys key key_len ref 


> ER -vr product ALL 


图 10-3 ”全 表 扫描 EXPLAIN 执行 结果 


执行 explain 命令 后 ， 展 现 信息 有 10 列 ， 分 别 是 id. select_type. table, type. possible_ 
keys、key、key_len、ref、rows、Extra， 下 面 对 这 些 字段 进行 讲解 : 

E id: SELECT 识别 符 。 这 是 SELECT 查询 序列 号 。 

E select_type: 表示 查询 中 每 个 select 子 句 的 类 型 。 

E table: 表示 查询 的 表 。 

E type: 表示 MySQL 在 表 中 找到 所 需 行 的 方式 ， 又 称 “ 访 问 类 型 ” 

常用 的 类 型 有 : NULL. system, const, eq_ref. ref. range, index, ALL 〈 从 左 到 右 ， 性 能 
从 好 到 差 )。 


O 设置 此 值 时 需要 注意 MySQL 的 文件 操作 权限 。 
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1) NULL: MySQL 在 优化 过 程 中 分 解 语句 ， 执 行 时 甚至 不 用 访问 表 或 索引 ， 例 如 从 一 个 索 
引 列 里 选取 最 小 值 可 以 通过 单独 索引 查找 完成 。 

2) system: 表 仅 有 一 行 ， 这 是 const 类 型 ， 一 般 不 会 出 现 ， 可 以 忽略 不 计 。 

3) const: 数据 表 最 多 只 有 一 个 匹配 行 ， 因 为 只 匹配 一 行 数据 ， 所 以 很 快 ， 常 用 于 
PRIMARY KEY 或 者 UNIQUE 索引 的 查询 ， 可 以 认为 const 是 最 优化 的 。 如 图 10-4 所 示 。 


t * from product where id=108; 


Gr 状态 


key_len ref rows Extra 


select_type table type possible_keys key 
PRIMARY 4 const 1 


SIMPLE product const PRIMARY 


图 10-4 “主键 查询 EXPLAIN 执行 结果 


4) eq ref: 使 用 的 索引 是 唯一 索引 ， 对 于 每 个 索引 键 值 ， 表 中 只 有 一 条 记录 匹配 ， 简 单 来 
说 ， 就 是 多 表 连 接 中 使 用 primary key 或 者 unique key 作为 关联 条 件 。 这 里 演示 使 用 方式 ， 添 加 
个 订单 表 t_order。 表 结构 如 下 : 

CREATE TABLE ‘t order’ ( 

“d` int(10) UNSIGNED NOT NULL AUTO_INCREMENT , 

‘name’ varchar(255) NULL DEFAULT NULL, 

‘product_id’ int(11) NULL DEFAULT NULL, 

num int(11) NULL DEFAULT NULL, 

‘user id int(11) NULL DEFAULT NULL, 

PRIMARY KEY (‘id’) 

) 
ENGINE=InnoDB DEFAULT CHARACTER SET=utf8 COLLATE=utf8_unicode_ci 


注意 t order 表 的 product id 与 商品 表 product 的 id 字段 进行 关联 。 如 图 10-5 所 示 。 


EXPLAIN |select * from product t,t_order o where t.id=o.product_id; 


结果 1 RR 状态 


key_len ref rows Extra 


select_type table type possible_keys key 
SIMPLE o ALL 
SIMPLE t eq_ref PRIMARY 


2 Using whe 
PRIMAR 4 javadev 1 


图 10-5 多 表 关 联 查 询 EXPLAIN 执行 结果 


5) ref: 查询 条 件 索 引 既 不 是 UNIQUE 也 不 是 PRIMARY KEY 的 情况 。ref 可 用 于 “=” 操 
作 符 的 带 索 引 的 列 。 这 里 以 product 表 的 price 字段 进行 演示 ， 此 字段 需 建立 索引 。 如 图 10-6 所 示 。 


where t.price = 34 


1 EXPLAIN select * fron 


select type table type possible keys key key_len ref rows Extra 


price inc5 const 1 


SIMPLE t ref price_index 


图 10-6 “索引 关联 查询 EXPLAIN 执行 结果 
6) Range: 只 检索 给 定 范围 的 行 ， 使 用 一 个 索引 来 选择 行 。 注 意 product 表 的 price 字段 建 
立 了 索引 。 如 网 10-7 所 示 。 
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图 10-7 ”范围 查询 EXPLAIN 执行 结果 


7) Index: Full Index Scan, index 与 ALL 的 区 别 是 index 类 型 只 遍历 索引 树 。 


8) ALL: MySQL 将 遍历 全 表 以 找到 匹 


配 的 行 〈 性 能 最 差 )。 


E possible_keys: 指出 MySQL 能 使 用 表 


个 索引 在 该 表 


没有 使 用 索引 ， 可 以 对 该 列 创建 索引 来 提高 性 能 


E key: 显示 MySQL 实际 决定 使 用 的 键 (索引 )。 如 果 没有 选择 索引 ， 键 是 


强制 使 用 索引 或 者 忽略 索引 。 


10.6.3 小 结 
对 于 数据 库 的 优化 要 注意 以 下 原则 : 


ref: 表示 上 述 表 的 连接 匹配 条 件 ’ 即 w 
rows: 显示 MySQL 认为 它 执行 查询 时 必须 检查 的 行 数 。 
Extra: 该 列 包含 MySQL 解决 查询 的 六 


EF 细 信息 


E 合理 的 索引 能 够 加 速 数 据 读 取 效率 ， 不 合 弄 


E 索引 越 多 ， 更 新 数据 的 速度 越 慢 。 


bP 些 列 或 第 


Co 


P 找 到 行 。 


key len: 表示 索引 中 使 用 的 字 节 数 ， 可 通过 该 列 计算 查询 中 使 用 的 索引 的 长 度 。 


量 被 用 于 查找 索引 列 上 的 值 。 


的 索引 会 拖 慢 数据 库 的 响应 速度 。 


如 果 该 列 为 NULL， 说 明 


NULL。 可 以 


图 当 程 序 和 数据 库 结 构 或 SQL 语句 已 经 优化 到 一 定 的 程度 ， 而 程序 瓶颈 并 不 能 顺利 解决 ， 
则 应 该 考虑 使 用 诸如 Redis 这 样 的 分 布 式 缓存 。 
m 用 EXPLAIN 来 分 析 SQL 语句 的 性 能 。 


E 索引 字段 上 进行 运算 会 使 索引 失效 。 尽 量 示 


10.7 ”数据库 主 从 复制 原理 


避免 在 WHERE 子 句 中 对 字段 进行 函数 或 表达 
式 操作 ， 这 将 导致 引擎 放弃 使 用 索引 而 进行 全 表 扫 描 。 
m 避免 使 用 != 或 二 、IS eee NOT NULL, IN, NOT IN 等 这 样 的 操作 符 。 因 为 这 会 
使 系统 无 法 使 用 索引 ， 而 只 能 直接 搜索 表 中 的 数据 。 
当然 优化 的 准则 远 远 不 止 这 些 ， 需 要 多 在 实际 工作 中 研究 探索 。 


MySQL 的 主 从 体系 中 ， 多 个 从 服务 器 采用 异步 的 方式 更 3 
行 写 或 修改 操作 是 在 主 服 务 器 上 进行 的 ， 读 操作 则 在 各 从 服务 器 上 进行 。 


MySQL 集群 之 间 复 制 的 基础 是 二 进 制 


库 和 主 数据 库 的 一 致 性 ， 也 就 实现 了 主 从 复 


志文 伯 
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F Cbinary log file). — 
启用 二 进 制 有 日志， 其 作为 master， 以 “事件 ”的 方式 把 数据 库 
中 ; 从 数据 库 slave 通过 一 个 IO 线程 与 主 服 务 器 master 保持 通信 ， 并 监控 master 的 二 
文件 的 变化 ， 如 果 发 现 master 二 进 制 日 志文 件 发 生变 化 ， 贝 
中 ， 然 后 slave 的 一 个 SQL 线程 会 把 相关 的 “事件 


”执行 到 


新 主 数据 库 的 变化 ， 业 务 朋 


及 务 器 执 


台 MySQL 数据 库 一 旦 


= 


T 


进 制 日 志 
I 会 把 变化 复制 到 自己 的 中 继 日 志 
己 的 数据 库 中 ， 以 此 实现 从 数据 


相应 操作 记录 到 二 进 制 日 志 


“117% MongoDB 


随 着 互联 网 业务 的 发 展 ， 传 统 的 关系 型 数据 库 RDBMS? (MySQL 等 ) 在 一 些 场合 遇 到 挑 
战 。 首 先 ， 对 数据 库存 储 的 容量 要 求 越 来 越 高 ， 单 机 无 法 满足 需求 ， 很 多 时 候 需 要 用 集群 来 解 
决 问题 ， 而 RDBMS 由 于 要 支持 join, union 等 操作 ， 一 般 不 支持 分 布 式 集群 。 其 次 ， 在 大 数据 
流行 的 今天 ， 很 多 数据 都 “频繁 读 和 增加 ， 不 频繁 修改 ” 而 RDBMS 对 所 有 操作 一 视 同 仁 ， 这 
就 带 来 了 空间 浪费 以 及 查询 性 能 问题 。 另 外 ， 互 联网 业务 的 不 确定 性 导致 数据 库 的 存储 模式 也 


需要 频繁 变更 ， 不 自由 的 存储 模式 增 大 了 实现 的 复杂 性 和 扩展 的 难度 。 而 非 关 系 型 数据 库 
NoSQLs 正 好 填补 了 这 块 空白 ，MongoDB 正 是 非 关 系 型 数据 库 的 代表 产品 之 一 。 


11.1 MongoDB 基本 介绍 


和 使 用 场景 


MongoDB 用 于 超大 规模 数据 的 存储 。 例 如 文章 信息 、 页 面 缓存 、 地 理 位 置 、 用 户 生 成 的 数 
据 和 用 户 操作 日 志 ， 如 果 要 对 这 些 数据 进行 存储 ， 那 么 关系 型 数据 库 相 对 于 MongoDB 就 逊色 不 
少 ，MongoDB 数据 库 的 使 用 能 很 好 地 处 理 这 些 数据 。 


11.1.1 MongoDB 概述 


MongoDB 是 用 C++ 语言 编写 的 ， 


是 一 个 基于 分 布 式 文件 存储 的 开源 数据 库 系统 。 在 高 负载 


的 情况 下 ， 可 添加 更 多 的 节点 ， 可 以 保证 服务 器 性 能 ， 可 为 应 用 提供 可 扩展 的 高 性 能 数据 存储 


解决 方案 ， 可 将 数据 存储 为 一 个 文档 ， 


MongoDB 有 以 下 优势 : 


保存 为 键 值 对 形式 。 


文档 结构 的 存储 方式 ， 获 取 数 据 方便 快捷 。 


类 似 Json 的 存储 格式 。 


高 效 存储 二 进 制 大 对 象 《〈 例 如 文件 、 照 片 、 视 频 )。 
内 置 GridFS， 支 持 大 容量 的 存储 。 


动态 查询 ， 全 索引 支持 ， 扩 展 到 内 部 对 象 和 内 雹 数组 。 


m 复制 (复制 集 ) 和 支持 自动 故障 恢复 。 


E MapReduce 支持 复杂 聚合 。 
MongoDB HAPE: 
E 不 文 持 事 务 操作 。 

E MongoDB 占用 空间 很 大 。 


图 无 法 进行 关联 表 查 询 ， 不 适用 于 关系 多 的 数据 。 
© RDBMS 即 关系 数据 库 管 理 系统 (Relational Database Management System)， 是 将 数据 组 织 为 相关 的 行 和 列 的 系统 ， 而 管理 关系 


数据 库 的 计算 机 软件 就 是 关系 数据 库 管理 系统 。 


© NoSQL， 指 的 是 非 关 系 型 的 数据 库 。NoSQL 有 时 也 称 作 Not Only SQL 的 缩写 ， 是 对 不 同 于 传统 的 关系 型 数据 库 的 数据 库 管 理 


系统 的 统称 。 
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加 复杂 聚合 操作 通过 MapReduce 创建 ， 速 度 慢 。 
11.1.2 MongoDB 使 用 场景 


基于 MongoDB 的 特性 ， 这 里 列举 MongoDB 的 使 用 场景 : 

(1) 日 志 / 内 容 / 图 片 /视频 等 业务 

MongoDB 更 侧重 数据 写 入 性 能 ， 而 非 事务 安全 ，MongoDB 很 适合 业务 系统 中 有 大 量 “ 低 
价值 ” 数据 的 场景 。 但 是 应 当 避 免 在 需要 事务 安全 性 的 业务 中 使 用 MongoDB， 除 非 能 在 架构 设 
计 上 保证 事务 安全 。 

(2) 高 可 用 性 业务 

MongoDB 的 复制 集 (Master-Slave) 配置 方便 ， 可 快速 处 理 单 节点 故障 ， 自 动 、 安 全 地 完 
成 故障 转移 。 

(3) 业务 数据 量 很 大 

关系 型 数据 库 的 弱点 是 完成 数据 的 扩展 较为 困难 ， 例 如 MySQL， 需 要 通过 数据 库 和 表 的 拆 
分 完成 扩展 。 而 MongoDB 内 建 了 多 种 数据 分 片 的 特性 ， 可 以 很 好 地 适应 大 数据 量 的 需求 。 

(4) 地 理 坐 标 数据 查询 

MongoDB 支持 二 维 空间 索引 ， 因 此 可 以 快速 、 精 确 地 从 指定 位 置 获 取 数 据 。 

(5) 存储 不 同 结构 数据 

MongoDB 是 文档 型 数据 库 ， 为 非 结 构 化 文档 数据 增加 一 个 新 字段 操作 简单 ， 并 且 不 会 影响 
到 已 有 数据 。 男 外 当 业 务 数据 发 生变 化 时 ， 不 需要 修改 表 结 构 。MongoDB 可 以 使 用 非 标准 的 关 
系 型 思想 (结构 化 〉 来 处 理 数据 ， 也 可 以 把 数据 直接 序列 化 成 Json 存储 到 MongoDB 中 。 


11.2 MongoDB 基本 操作 


MongoDB 的 安装 相对 简单 ， 访 问 官网 https:/www.mongodb.com， 然 后 下 载 合适 的 版 本 即 
可 。 例 如 Windows 系统 ， 只 需 在 MongoDB 官网 下 载 msi 文件 ， 双 击 运行 即 可 。 
本 书 的 MongoDB 软件 环境 采用 Docker 容器 部 署 。 具 体 部 署 命令 见 第 19 章 。 


11.2.1 MongoDB 基本 命令 


在 MongoDB 中 默认 数据 库 是 test。 如 果 没 有 创建 过 任何 数据 库 ， 则 集合 /文档 将 存储 在 test 
数据 库 
创建 数据 库 
> use db name 
要 检查 当前 选择 的 数据 库 ， 使 用 命令 db: 
>db 
检查 数据 库 列 表 : 
> show dbs 


为 单个 数据 库 添加 管理 用 户 ， 例 如 给 admin 数据 库 创 建 一 个 用 户 名 为 roots BEAN root 的 


> use admin 
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sda URS aang acon arb ati al ca ead od) 
创建 完 root 用 户 后 ， 再 次 操作 admin 数据 库 时 ， 需 要 进行 身份 认证 ， 具 体 如 下 : 
> mongo 宿主 机 ijp/ 数 据 库 名 —u 用 户 名 —p 密码 
例如 用 root 用 户 登录 本 机 admin 数据 库 : 


> mongo localhost/admin -uroot -proot 
下 面 介绍 MongoDB 集合 操作 。 集 合 的 创建 方式 分 两 种 : 隐 式 创建 集合 和 显 式 创建 有 
E 蜂 式 创建 集合 
当 向 集合 中 插入 文档 时 ， 如 果 集 合 不 存在 ， 系 统 会 自动 创建 ， 所 以 向 一 个 不 存在 的 集合 ! 
插入 数据 也 就 是 创建 了 集合 。 
>db 
test 
> show tables 
> db.products.insert({"name": 
WriteResult({ "nInserted" : 1 }) 


> show tables 
products 


m 显 式 创建 集合 
db.createCollection(“ 集 合 名 ” 配置 参数 ) 

显示 创建 集合 可 以 通过 一 些 配 置 参数 创建 一 些 特殊 的 集合 ， 如 固定 和 
> db.createCollection("orders") 
{ "ok": 1 } 

删除 集合 ， 格 式 为 : db. 集合 名 字 .drop()。 


> db.orders.drop() 
true 


合 写 入 数据 。 
> var product = {"name": "java dev map",”*price”’:199} 
> db.products.insert(product) 
WriteResult({ "nInserted" : 1 }) 
到 此 ， 本 节 已 经 介绍 了 常用 的 MongoDB 命令 ， 如 果 想 了 解 更 多 MongoDB 命令 ， 可 以 登录 
MongoDB 官网 进行 学 习 。 


11.2.2 MongoDB 图 形 化 工具 


MongoDB 自 带 的 Shell 是 一 个 很 好 的 工具 ， 但 是 它 在 操纵 大 数据 集 时 就 没 那么 直观 了 。 使 用 
MongoDB 客户 端 管理 工具 ， 可 以 大 大 提高 MongoDB 应 用 的 开发 效率 。 这 里 介绍 一 个 简单 的 
MongoDB 可 视 化 查看 工具 Robomongo2。 只 要 通过 如 图 11-1 所 示 页 面 ， 正 确 配 置 MongoDB 的 地 
址 和 密码 ， 即 可 登录 MongoDB， 然 后 查看 MongoDB 中 的 数据 ， 如 图 11-2 所 示 。 


amr 
I 


'javadevmap", "level": 6}) 


n> 


mi 


T 


© Robomongo 是 一 个 基于 Shell 的 跨 平 台 开 源 MongoDB 可 视 化 管理 工具 。 官 网 是 https://robomongo.org/。 
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~ i i 5 ，， 
Create, edit, remove, clone or reorder connections via drag n drop. 


= ooon hase / User 
/ jf 


上 root 


[E| Connection Settings 


Connection Authentication SSH Advanced 


Name: New Connection 


Choose any connection name that will help you to identity 
this connection. 


localhost : [27017 


Specity host and port ot MongoDB server. Host can be 
either IPv4, IPv6 or domain name. 


Cad 


图 11-1 Robomongo 配置 


® Robomongo 0.9.0-RC9 


File View Options Window Help 
a — al >a 
v E javaDevMap (3) 
v System 
Si 8 admin javaDevMap * 39. 107.230. 169:27017 admin 
s Collections (4) 
System 


O ab. getCollection(’ product" 


db.getCollection('product') .find({}) 


item product (W) 0.008 sec. 
v [ product 
Indexes 


Key Value 
© (1)1 {4 fields } 
© (2) 2 {4fields} 
© (3) 4 {4 fields } 
© (4)6 {4 fields } 
© (5)9 {4 fields } 
v @ (9 55 {5 fields } 
#) id 55 


Functions 
Users 
& local 
E config 


com.javadevmap.mongodbexample.... 


java dev map 
#) price 221 
== htmlDetail <p> <img src="http://101.201.39.63/g... 


图 11-2 查看 MongoDB 数据 


因为 这 是 个 可 视 化 工具 ， 所 以 使 用 起 来 非常 简单 ， 使 用 此 工具 基本 可 以 完成 对 MongoDB 
所 文 持 的 增删 改 查 等 任何 操作 。 此 工具 的 具体 使 用 这 里 就 不 再 演示 ， 只 要 熟悉 使 用 方法 即 可 。 


11.3 SpringBoot 集成 MongoDB 


‘qu 


创建 一 个 Spring Boot 工程 ， 工 程 名 使 用 MongodbExample， 上 有 具体 创建 方法 见 第 7 章 。 本 节 
使 用 Spring Boot 工程 整合 MongoDB 进行 数据 操作 。 


11.3.1 整合 MongoDB 


C1) 添加 依赖 
为 了 整合 MongoDB， 需 要 添加 起 步 依 赖 spring-boot-starter-data-mongodb; 后 面 的 章节 需 
要 使 用 页 面 进 行 演示 ， 所 以 还 要 添加 起 步 依赖 spring-boot-starter-thymeleaf， 具 体 如 下 : 
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<dependencies> 
<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-data-mongodb</artifactId> 
</dependency> 
<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-thymeleaf</artifactId> 
</dependency> 
</dependencies> 


(2) 修改 配置 文件 
在 配置 文件 application.yml 中 添加 如 下 配置 ， 使 用 root 用 户 操作 数据 库 admin: 


Spring: 
application: 
name: mongodb-example 
data: 
mongodb: 
host: 39.107.230.169 
port: 27017 
database: admin 
username: root 
password: root 


只 要 以 上 两 步 ， 即 可 完成 MongoDB 的 Spring Boot 工程 整合 。 


11.3.2 ”操作 数据 


Mongodb 实现 商品 的 增删 改 查 功能 ， 首 先 要 定义 商品 的 数据 结构 。 创 建 包 com.javadevmap. 
mongodbexample.model， 然 后 新 建 Product 类 ， 有 具体 如 下 : 


package com.javadevmap.mongodbexample.model; 
import org.springframework.data.annotation.Id; 
public class Product { 

CId 

private Integer id; 

private String name; 

private int price; 

Pee 产品 页 面 对 应 的 商品 详情 */ 

private String htmlDetail; 


public Product() { 

} 

public Product(Integer id, String name, int price) { 
this.id = id; 
this.name = name; 
this.price = price; 

} 

//... 省 略 get 与 set 方法 

@Override 

public String toString() { 
return "Product {" + 

"id=" + id + 
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注意 类 中 的 id 字段 上 面 ， 增 加 了 一 个 @Id 注解 ， 让 id 字段 作为 Product 文档 的 唯一 标识 ， 


", name=" + name 十 \" + 
", price=" + price + 


es 


MongoDB 第 用 注解 见 表 11-1. 


表 11-1 MongoDB 常用 注解 


标签 名 作 
@Id 文档 的 唯一 标识 ， 在 MongoDB 中 为 ObjectId， 它 是 唯一 的 
@Document 把 一 个 Java 类 声明 为 MongoDB 的 文档 ， 可 以 通过 collection 参数 指定 这 个 类 对 应 的 文档 
@Indexed 声明 该 字段 需要 索引 ， 建 索引 可 提高 查询 效率 
@CompoundIndex 复合 索引 的 声明 ， 建 复合 索引 可 以 有 效 地 提高 多 字段 的 查询 效率 
@GeoSpatiallndexed 声明 该 字段 为 地 理 信息 的 索引 
@Transient 映射 忽略 的 字段 ， 该 字段 不 会 保存 到 MongoDB 


创建 完 上 面 的 实体 类 Product， 接 下 来 创建 一 个 操作 类 ProductMongoRepository 来 进行 
MongoDB 的 操作 ， 此 类 提供 了 针对 MongoDB 的 增删 改 查 功能 ， 只 要 继承 MongoRepository， 


就 继承 了 一 些 默 认 的 方法 ， 主 要 包含 如 下 几 类 : delete、find、save、count、exists。 此 类 实现 具 


体 如 下 : 


i 


@Component 
public interface ProductMongoRepository extends MongoRepository<Product, Integer> { 


j 


类 中 不 需要 实现 任何 方法 ， 当 前 ProductMongoRepository 已 经 具备 了 基本 的 增删 改 查 人 


=p 
CC 
过 


了 。 编 写 一 个 测试 类 进行 验证 : 
@RunWith(SpringRunner.class) 


@SpringBootTest 
public class ProductMapperTest { 


} 


@Autowired 
ProductMongoRepository productMongoRepository; 


@Test 

public void testMongoOrigin() { 
productMongoRepository.deleteAllQ); 
productMongoRepository.insert(new Product(101, "product01", 18)); 
System.out.println("mongo data find by id"); 
System.out.println(productMongoRepository.findOne(101)); 
productMongoRepository.delete(101); 


ae 


行 结果 如 下 : 


mongo data find by id 
Product {id=101, name='product01', price=18} 
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当 这 些 默认 方法 不 能 上 覆盖 所 有 业务 的 数据 操作 需求 时 ， 就 需要 扩展 方法 。 扩 展 使 用 方法 
时 ， 就 好 像 用 英文 直译 要 做 的 事情 一 样 来 定义 方法 名 ， 例 如 想 通 过 id 来 查找 菜 条 数据 ， 只 要 定 
义 一 个 方法 findById， 这 样 就 具备 了 通过 id 查找 的 能 力 。 下 面 在 ProductMongoRepository 中 定 
义 儿 个 方法 来 扩充 基础 的 数据 库 操作 能 力 。 
@Component 
public interface ProductMongoRepository extends MongoRepository<Product, Integer> { 
Product findByName(String name); 
List<Product> findByPrice(int id); 
List<Product> findByPriceLessThan(int price); 
Product findOneByPrice(Integer price); 
Product findOneByPriceAndName(Integer price,String name); 
List<Product> findByPrice(Integer price, Pageable page); 


j 
如 上 面 所 写 ， 只 要 把 想 做 的 事 按 照 IPA 的 规则 命名 一 个 方法 ， 即 完成 了 MongoDB 操作 语 
句 的 建立 ， 使 用 以 上 规则 (参见 7.5.2 节 )， 就 可 以 自由 组 装 接 口 方法 来 扩展 数据 库 操 作 能 


11.3.3 ”缓存 商品 详情 页 面 功 能 


节 实 现 用 MongoDB 存储 商品 详情 html 页 面 的 功能 。 将 部 分 页 面 信息 存储 到 MongoDB 
中 ， 当 用 户 访问 某 个 商品 详情 时 ， 根 据 商品 id 从 MongoDB 中 取出 ， 返 回 给 前 台 。 


C1) 准备 数据 
准备 商品 的 详情 页 面 主要 内 容 作为 要 缓存 的 数据 ， 有 共 体 如 下 : 
<p>< img src="http://t.cn/R3cquJp" alt=""/>< img sre="http://t.cn/R3cShfe" alt=""/></p> 


Ba 


把 此 内 容 通过 test 类 保存 到 Mongodb 中 。 


@RunWith(SpringRunner.class) 
@SpringBootTest 
public class ProductMapperTest { 
@Autowired 
ProductMongoRepository productMongoRepository; 
@Test 
public void addProductOne() { 
productMongoRepository.delete(55); 
Product product = new Product(); 
product.setId(55); 
product.setName("java dev map"); 
product.setPrice(221); 
product.setHtmlDetail("<p>< img src="http://t.cn/R3cquJp" alt=""/>< img srce="http://t.cn/ 
R3cShfe" alt='""/></p>"); 
Product result = productMongoRepository.insert(product); 
System.out.printIn(result); 


} 
执行 以 上 程序 ， 页 面 数据 已 经 保存 到 MongoDB 中 。 当 然 实 际 业 务 中 ， 上 面 的 商品 详情 代 
码 需 后 台 管理 人 员 编 辑 商 品 时 进行 生成 。 
(2) 准备 展示 页 面 
接 下 来 定义 一 个 展示 页 面 ， 在 resources 文件 夹 下 新 建 一 个 template 文件 夹 ， 新 建 页 面 
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detail.html 文件 ， 此 页 面 用 来 展示 从 MongoDB 4 


detail 文件 中 使 用 了 一 个 CSS 样式 文件 product.css， 此 文件 为 静态 资源 文件 ， 和 图 片 等 静态 
资源 一 起 存放 在 /resources/static 文件 夹 下 ， 主 要 是 为 了 美化 页 面 样式 ， 这 里 就 不 再 展示 代码 。 


detail 展示 页 面 需要 将 一 段 html 代码 放 到 页 面 中 ， 需 要 使 用 thymeleaf 进行 非 转 义 文本 处 


取 的 商品 详情 代码 ， 其 体 如 下 : 


ot 


<html xmlns:th="http://www.thymeleaf.org"> 
<head> 
<meta charset="UTF-8"/> 
<title> 商 品 详情 页 面 </title> 
<link rel="stylesheet" href="/product.css"/> 
</head> 
<body> 
<div class="switchable—panel"> 
<div> 
<label style="font-size:48px;display:block;width: 100%;text—align:center" 
th:text="$ {tips}"></label> 


</div> 

<div></div> 

<div class="panel—intro" th:utext="$ {desc}"></div> 
</div> 
</body> 
</html> 


(3) 


创建 包 


理 ， 即 使 用 th:utext 标签 进行 处 理 


HS 


o 


处 理 HTTP 请 求 


MongoDB 中 的 数据 与 页 面 关 联 起 来 ， 具 体 如 下 : 


@Controller 
@RequestMapping(value="/product") 
public class ProductDetailController { 
@Autowired 
private ProductMongoRepository productRepository; 


@RequestMapping(value="/{ productId} /detail") 
public ModelAndView getProductDesc(@PathVariable("productld") Integer productId) { 


Product product = productRepository.findOne(productld); 
ModelAndView modelAndView = new ModelAndView("detail"); 
if(null == product) { 
modelAndView.addObject("tips",String.format("ajim id 为 %s 不 存在 ",productId)); 
}else{ 


modelAndView.addObject("tips",String.format(" 商 品 %s 的 商品 详情 页 面 "productgetName0)); 


modelAndView.addObject("desc" product.getHtmlDetail()); 
} 


return modelAndView; 


j 


com.javadevmap.mongodbexample.controllers ， 定 义 ProductDetailController 类 ， 将 


在 ProductDetailController 中 定义 一 个 接口 方法 ， 用 于 接收 前 端 传递 的 id， 然后 去 MongoDB 
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第 11 章 MongoDB 


商品 java dev map 的 商品 详情 页 面 


y mongoDB 


图 11-3 商品 详情 页 面 
对 于 一 个 电 商 平台 来 讲 ， 可 以 使 用 如 上 方法 把 商品 详情 保存 在 MongoDB Y 
求 返回 页 面 信息 。 


O 


~ 


并 且 根 据 请 


21 


在 实际 业务 
业务 量 的 


， 如 果 仅 使 有 
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术 使 数据 库 的 承载 能 力 提 高 ， 但 还 有 
缓存 凭借 着 超 强 的 数据 读 写 能 


种 可 以 显 


A be 


Redis 


HR FE, MA WORT HEAT SE Oe ERE, AEB 
上 升 ， 就 会 遇 到 数据 库 的 性 能 瓶颈 ， 虽 然 可 以 通过 优化 数据 库 或 者 使 用 读 写 分 离 等 技 


能 的 方式 : 添加 缓存 。 


， 能 够 承担 非常 大 的 业务 请 求 压 力 ， 并 且 


一 些 不 适合 存 入 


数据 库 的 数据 放 入 缓存 中 也 是 一 种 不 错 的 选择 。 缓 存 分 为 本 地 缓存 和 分 布 式 缓存 ， 本 章 仅 介 绍 


分 布 式 缓存 Redis。 


Redis 支持 数据 的 持久 化 ， 可 以 在 重启 Redis 时 把 持久 化 的 数据 再 加 载 进 缓存 ，Redis 提供 
了 5 种 数据 格式 的 存储 ， 分 别 是 String、List、Hash、Set、ZSet; Redis 支持 数据 的 备份 ， 也 就 
到 每 秒 10 万 次 左 


是 可 以 建立 多 节点 。 单 台 Redis 在 不 考虑 网 络 的 情况 下 ， 可 以 j 


达 


力 。 所 以 对 于 一 名 研发 者 来 ; 


12.1 基本 的 Redis 操 


本 章 使 用 Spring Boot 工程 添加 Redis 4H 14 


用 好 Redis 会 让 工作 变 


， 使 


作 


RedisExample， 然 后 进行 如 下 操作 。 


C1) 添加 组 件 依赖 


<dependency> 


<groupId>org.springframework.boot</groupId> 
<artifactId>spring—boot-starter-data-redis</artifactld> 


</dependency> 


Sat 


(2 


添加 Redis 的 配置 信息 至 yml 文件 


下 


server: 
port: 18081 

spring: 
application: 


name: redis-example 


redis: 
database: 0 


host: 39.106.10.196 


port: 6379 
password: mypass 
pool: 


max~active: 1000 


max-wait: 1000 

max~idle: 300 

min-idle: 100 
timeout: 1200 


(3) 添加 Redis 基本 操作 
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在 工程 内 ， 新 建 RedisDao 接口 和 它 的 实现 类 ， 本 节 先 简单 地 向 Redis 中 添加 一 个 String 
类 型 的 数据 。 
public interface RedisDao { 

public void testRedisString(); 


} 
@Repository 
public class RedisDaoImpl implements RedisDao{ 
@Autowired 
private RedisTemplate<String, String> redisTemplate; 
@Override 
public void testRedisString() { 
redisTemplate.opsForValue().set("String:stringredis", "string redis value"); 
String redisString = redisTemplate.opsFor Value().get("String:stringredis"); 
System.out.println(redisString); 
} 
} 
上 面 的 代码 中 ， 使 用 RedisTemplate 对 Redis 进行 操作 ， 对 于 Redis 中 的 String 类 型 ， 使 用 


redisTemplate.opsForValue() 作 为 数据 操作 的 方式 。 由 于 Redis 主要 是 通过 键 值 对 进行 存储 的 ， 
所 以 set 方法 把 “String:stringredis” 作 为 key, “string redis value” 作 为 value FA Redis 中 。 在 
key 字符 串 中 的 “:” 起 到 了 命名 空间 的 作用 ， 可 以 标识 Redis 中 某 一 类 数据 的 分 组 ， 并 且 在 查 
看 工具 中 会 根据 命名 空间 自动 分 类 聚合 。 
(4) 使 用 测试 类 测试 效果 
在 test 类 中 ， 添 加 如 下 测试 代码 ， 检 验 Redis 的 使 用 情况 。 

@RunWith(SpringRunner.class) 

@SpringBootTest 

public class RedisExampleApplicationTests { 


@Autowired 
private RedisDao redisDao; 


@Test 
public void testRedisString() { 
redisDao.testRedisString(); 


} 


} 
运行 结果 如 下 : 

string redis value 
在 测试 类 中 注入 RedisDao 类 的 实例 ， 然 后 调用 Dao 中 的 方法 ， 由 输出 可 见 可 以 获取 
Redis 中 的 数据 。 


12.2 Redis 常用 命令 和 可 视 化 工具 


上 一 节 通 过 代码 把 一 个 String 类 型 的 数据 存 入 Redis 中 。 那 么 如 何 查 看 Redis 中 的 数据 
WE? 这 里 介绍 两 种 办 法 。 一 种 是 直接 登录 Redis 缓存 ， 通 过 命令 查看 Redis 数据 ; 男 一 种 是 通 
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过 可 视 化 工具 查看 Redis 中 的 数据 。 
12.2.1 Redis 命令 


Redis 的 命令 较 多 ， 本 节 简 单 介绍 几 个 常用 命令 ， 如 图 12-1 所 示 。 
图 中 ， 使 用 redis-cli 命令 连接 到 了 Redis; 通过 AUTH 命令 输入 密码 登录 ; 通过 keys fir 
令 查 看 符合 正则 规则 的 key 列表 ， 本 例 匹 配 了 全 部 的 key; 通过 del 命令 删除 某 个 key 值 。 
Redis 的 命令 还 有 很 多 ， 可 以 通过 Redis 命令 直接 操作 Redis， 实 现 各 种 类 型 的 数据 操作 ， 但 是 
对 于 研发 者 来 讲 ， 这 些 命令 了 解 即 可 ， 使 用 可 视 化 的 操作 工具 会 更 加 方便 。 


12.2.2 可视化 工具 


本 节 介 绍 一 个 简单 的 Redis 可 视 化 查看 工具 Redis Desktop Manager。 只 要 通过 如 图 12-2 
所 示 界 面 ， 正 确 配 置 Redis 的 地 址 和 密码 ， 即 可 登录 到 Redis 上 。 然 后 就 可 以 查看 Redis 中 的 
数据 ， 如 图 12-3 所 示 。 


Connection SSL SSH Tunnel Advanced Settings 


Name jredis 


Host: |39. 106. 10. 196 


root@4d3b186431bb: /data# redis-cli pu T] 
127.0.0.1:6379> AUTH mypass 


OK 

127.0.0.1:6379> keys * 
1) "string:stringredis" Auth: [nypass 
127.0.0.1:6379> del string:stringredis 

Cinteger) 1 

127.0.0.1:6379> keys * 


Cempty list_or set Test Connection OK Cancel 
127.0. 0.1:6379> 
图 12-1 Redis 命令 图 12-2 Redis Desktop Manager 配置 


y @ redis 
vdo (1/0) 
v D String (1) 


redis: : db0: : String: stringredis % 


$ STRING: |String: stringredis TTL: -1 Rename @ Delete Reload Value | Set TIL 
String: stringredis — = 


F) abi (0) Value: 
5 oe i string redis value 
Fj db4 (0) 
F) db5 (0) 
F) db6 (0) 
F) db7 (0) 
F) db8 (0) 
F) db9 (0) 
Fj dbl0 (0) 
E) dbll (0) 
F) db12 (0) 
F) db13 (0) Save 
E) tb14 (0) 
E) db15 (0) 


View as: Plain Text $4 


图 12-3 Redis Desktop Manager 操作 数据 

因为 这 是 个 可 视 化 工具 ， 所 以 使 用 起 来 非常 简单 ， 使 用 此 工具 基本 可 以 完成 对 Redis 所 文 
持 的 增删 改 查 等 任何 操作 ， 并 且 还 可 以 设置 数据 展示 的 格式 。 此 工具 的 有 具体 使 用 这 里 就 不 再 演 
示 ， 大 家 自行 熟悉 使 用 方法 即 可 。 
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12.3 Redis 的 五 种 数据 格式 的 操作 
Redis 支持 五 种 数据 类 型 的 操作 ， 所 以 可 以 使 用 Redis 做 很 多 事情 ， 例 如 简单 的 信息 放 入 


StringS 类 型 中 ;， AP 


值 对 类 型 的 数据 放 入 Hash 中 ;队列 可 以 放 入 List 中 ; 一些 集合 数据 可 


以 放 入 Set 和 ZSet F. 


五 种 类 型 的 数据 操作 方式 见 表 12-1。 


表 12-1 Redis 操作 数据 类 型 


类 H 数据 操作 方式 
String redisTemplate.opsForValue() 
List redisTemplate.opsForList() 
Hash redisTemplate.opsForHash() 
Set redisTemplate.opsForSet() 
ZSet redisTemplate.opsForZSet() 


12.3.1 String 操作 


本 节 使 用 的 方法 如 下 。 读 者 应 首先 了 解 各 个 方法 的 作用 ， 然 后 阅读 代码 和 输出 ， 了 解 
Redis 是 如 何 操作 String 类 型 数据 的 。 


E set: 问 Redis 
时 删除 。 
get: 获取 Redi 


退 加 数据 。 


multiSet: 同时 


@Override 


getAndSet: 获取 旧 的 值 ， 并 且 设置 新 的 值 。 
size: 获取 字符 串 长 度 。 
append: 如 果 Redis 中 不 包含 此 键 ， 则 添加 键 和 值 ， 如 果 已 经 包含 此 键 ， 则 在 值 的 后 面 


multiGet: 同时 获取 多 个 键 的 值 。 
increment: 对 某 一 值 进行 数值 操作 。 


中 设置 键 和 值 ， 重 载 方法 中 包含 一 个 带 有 过 期 时 间 的 方法 ， 可 以 设置 直 


fay 


s 中 的 键 和 值 。 


setIfAbsent: 如 果 没 有 此 键 ， 则 向 Redis 中 添加 键 和 值 。 


添加 多 个 String 的 键 和 值 。 


public void testRedisString() { 
redisTemplate.opsForValue().set("String:stringredis", "string redis value"); 
String redisString = redisTemplate.opsForValue().get("String:stringredis"); 
System.out.println(redisString); 
redisString = redisTemplate.opsForValue().getAndSet("String:stringredis", "string redis value 2"); 
System.out.println(redisString); 
redisString = redisTemplate.opsForValue().get("String:stringredis"); 
System.out.println(redisString); 


Long size 


= redisTemplate.opsForValue().size("String:stringredis"); 


System.out.println("'size is " + size); 


redisTemplate.opsForValue().append("String:stringappend", "stringappend%"); 


© Java 对 象 的 保存 也 可 


以 转 成 Json 格式 后 ， 存 入 String 类 型 中 。 
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redisString = redisTemplate.opsForValue().get("String:stringappend"); 
System.out.println(redisString); 
redisTemplate.opsForValue().append("String:stringappend", "stringappend"); 
redisString = redisTemplate.opsForValue().get("String:stringappend"); 
System.out.println(redisString); 


redisTemplate.opsForValue().set("String:stringredistimeout", "stringredis timeout 10 seconds",10, 
TimeUnit. SECONDS); 

redisString = redisTemplate.opsForValue().get("String:stringredistimeout"); 

System.out.println(redisString); 


boolean settype = redisTemplate.opsForValue().setIfAbsent("String:stringredisifabsent", "string redis 
ifabsent"); 

System.out.println("set type is " + settype); 

settype = redisTemplate.opsForValue().setIfAbsent("String:stringredis", "string redis ifabsent"); 
System.out.println("set type is " + settype); 

redisTemplate.delete("String:stringredis"); 

settype = redisTemplate.opsForValue().setIfAbsent("String:stringredis", "string redis ifabsent"); 
System.out.println("set type is " + settype); 


Map<String, String> map = new Hash Map<String, String>(); 
map.put("String:strings1", "strings1"); 
map.put("String:strings2", "strings2"); 
map.put("String:strings3", "strings3"); 
redisTemplate.opsForValue().multiSet(map); 

List<String> keys = new ArrayList<String>(); 
keys.add("String:strings 1"); 

keys.add("String:strings2"); 

keys.add("String:strings3"); 

List<String> values = redisTemplate.opsForValue().multiGet(keys); 
System.out.println(values.toString()); 


redisTemplate.opsForValue().increment("String:num", 1); 
redisString = redisTemplate.opsForValue().get("String:num"); 
System.out.println("num is " + redisString); 
redisTemplate.opsForValue().increment("String:num", 1); 
redisString = redisTemplate.opsForValue().get("String:num"); 
System.out.println("num is " + redisString); 


Set<String> stringkeys = redisTemplate.keys("String*"); 
redisTemplate.delete(stringkeys); 


} 

运行 结果 如 下 : 
string redis value 
string redis value 
string redis value 2 
size is 20 
stringappend% 
stringappend%stringappend 
stringredis timeout 10 seconds 
set type is true 
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set type is false 

set type is true 

[strings 1, strings2, strings3] 
num is 1 

num is 2 


上 面 的 代码 并 不 复杂 ， 没 有 包含 业务 逻辑， 仅仅 是 Redis 操作 的 API 效果 演示 。 其 中 注意 
几 点 : getAndSet 方法 取出 来 的 是 旧 值 ，append 方法 在 没有 键 时 ， 效 果 和 set 相同 ; TimeUnit 
的 超时 类 型 有 很 多 种 ， 可 以 根据 实际 需要 选择 ，setIfAbsent 在 有 键 时 会 设置 失败 ; increment 方 
法 在 没有 键 和 值 时 默认 从 0 开始 ; 最后， 通过 redisTemplate.delete0) 方 法 删除 了 所 有 的 符合 正 
则 规则 的 键 和 值 。 


12.3.2 List 操作 


对 于 List 类 型 的 操作 ， 可 以 直接 把 Redis 中 的 键 设想 为 List 的 名 字 ，Redis 中 的 值 就 是 一 
个 List， 可 以 像 普 通 List 一 样 进行 Push、Pop 等 操作 ，List 操作 的 具体 方法 如 下 : 
E rightPushAll: 从 List 的 末尾 ， 插 入 全 部 的 List 参数 中 的 内 容 。 
range: 获取 List 某 区 间 内 的 内 容 。 
leftpush: 从 List 的 前 端 插入 ， 重 载 方法 中 包含 从 List 的 某 个 值 的 前 端 插入 。 
size: 获取 List 的 数据 个 数 。 
leftPop: 从 前 端 弹出 。 
rightPopAndLeftPush: 从 一 个 List HY Jaan 
et: 修改 List 中 的 某 个 值 。 
E trim: 截取 List. 
代码 如 下 : 
@Override 
public void testRedisList() { 
List<String> list = new ArrayList<String>(); 
list.add("listString 1"); 
list.add("listString2"); 
list.add("listString3"); 
list.add("listString4"); 
redisTemplate.opsForList().rightPushAll("List:list", list); 
List<String> retlist = redisTemplate.opsF orList().range("List:list", 0, 2); 
System.out.println(retlist.toString()); 
retlist = redisTemplate.opsForList().range("List:list", 0, —1); 
System.out.println(retlist.toString()); 


rer 
IEE 


8 上， 并 插入 一 个 List 的 前 端 。 


redisTemplate.opsF orList().leftPush("List:list", "listString0"); 
redisTemplate.opsForList().rightPushAll("List:list", "listString5","listString6","listString8"); 
redisTemplate.opsForList().leftPush("List:list", "listString8", "listString7"); 

retlist = redisTemplate.opsForList().range("List:list", 0, —1); 
System.out.println(retlist.toString()); 

long size = redisTemplate.opsF orList().size("List:list"); 

System.out.println("'size is " + size); 


redisTemplate.opsForList().leftPop("List: list"); 
redisTemplate.opsForList().rightPopAndLeftPush("List:list", "List:list"); 
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retlist = redisTemplate.opsForList().range("List:list", 0, —1); 
System.out.println(retlist.toString()); 


redisTemplate.opsForList().set("List:list", 0, "listString0"); 
retlist = redisTemplate.opsForList().range("List:list", 0, —1); 
System.out.println(retlist.toString()); 
redisTemplate.opsForList().trim("List:list", 1, 3); 

retlist = redisTemplate.opsForList().range("List:list", 0, —1); 
System.out.println(retlist.toString()); 


Set<String> listkeys = redisTemplate.keys("List*"); 
redisTemplate.delete(listkeys); 


j 
运行 结果 如 下 : 

[listStringl, listString2, listString3] 
[listStringl, listString2, listString3, listString4] 
[listString0, listStringl, listString2, listString3, listString4, listString5, listString6, listString7, listString8] 
size is 9 
[listString8, listString1, listString2, listString3, listString4, listStringS, listString6, listString7] 
[listString0, listString1, listString2, listString3, listString4, listStringS, listString6, listString7] 
[listString1, listString2, listString3] 


上 面 的 代码 中 ， 先 通过 rightPushAll 插入 一 个 List 数据 ， 用 range 节选 输出 后 ， 在 List 前 
端 和 后 端 分 别 向 List 中 添加 数据 ， 并 且 还 在 特定 位 置 添 加 了 一 个 数据 ; 之 后 做 了 前 端 弹出 的 操 


作 ， 然 后 把 最 后 一 个 数据 放 到 List 的 前 面 ， 用 set 方法 修改 List 4 


行 节选 。 


12.3.3 Hash 操作 


Hash 类 型 的 Redis 比较 特殊 ， 因 为 此 类 型 的 Redis 值 中 保存 的 还 是 一 组 键 值 对 。 首 先 看 
常用 方法 : 
putAll: 把 hashmap 全 部 加 入 Redis 某 值 中 。 


Hash 类 型 的 


size: 


get: 


keys: 
values: 获取 Redis 值 中 的 hashmap 中 的 值 的 列表 。 
entries: 获取 Redis 值 中 的 hashmap. 
hasKey: 判断 Redis 值 中 的 hashmap 是 否 包含 此 key。 
获取 Redis 值 中 的 hashmap 某 个 键 对 应 的 值 数据 。 
delete: 删除 Redis 值 中 的 hashmap 的 某 个 键 值 对 。 
putlfAbsent: 如 果 Redis 值 中 的 Hashmap 不 包含 此 键 值 对 ， 则 添加 。 


获取 Redis 值 中 的 hashmap 的 键 值 对 个 数 。 
获取 Redis 值 中 的 hashmap 中 的 键 的 集合 。 


加 put: 向 Redis 值 中 的 hashmap 添加 键 值 对 。 
代码 如 下 : 


@Override 
public void testRedisHash() { 
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map.put("key3", "hash value 3"); 

map.put("key4", "hash value 4"); 
redisTemplate.opsForHash().putAll("Hash:map", map); 

System.out.println("size is " + redisTemplate.opsForHash().size("Hash:map")); 
Set<Object> keys = redisTemplate.opsForHash().keys(""Hash:map"); 
System.out.println(keys.toString()); 

List<Object> values = redisTemplate.opsForHash().values("Hash:map"); 
System.out.println(values.toString()); 

Map<Object, Object> retmap = redisTemplate.opsForHash().entries("Hash:map"); 
System.out.println(retmap.toString()); 


System.out.printIn("has key4 =" + redisTemplate.opsForHash().hasKey("Hash:map", "key4")); 
String value = (String) redisTemplate.opsForHash().get("Hash:map", "key4"); 
System.out.println("key4 value is " + value); 

redisTemplate.opsForHash().delete("Hash:map", "key4"); 

retmap = redisTemplate.opsForHash().entries("Hash:map"); 
System.out.println(retmap.toString()); 

redisTemplate.opsForHash().putIfAbsent("Hash:map", "key4", "hash value 4"); 
redisTemplate.opsForHash().put("Hash:map", "key5S", "hash value 5"); 

retmap = redisTemplate.opsForHash().entries("Hash:map"); 
System.out.println(retmap.toString()); 


Set<String> mapkeys = redisTemplate.keys("Hash*"); 
redisTemplate.delete(mapkeys); 
j 


行 结果 如 下 : 

size 1s 4 

[keyl, key2, key3, key4] 

[hash value 1, hash value 2, hash value 3, hash value 4] 

{key4=hash value 4, key1=hash value 1, key3=hash value 3, key2=hash value 2} 

has key4 = true 

key4 value is hash value 4 

{key3=hash value 3, key2=hash value 2, key1=hash value 1} 

{key2=hash value 2, key4=hash value 4, keyS=hash value 5, key3=hash value 3, key1=hash value 1} 

上 面 的 代码 较为 简单 ， 仅 按照 代码 的 顺序 和 输出 对 应 阅读 即 可 理解 。Redis 对 Hash 类 型 
的 支持 让 Redis 的 使 用 场景 更 广 了 ， 但 是 在 工作 中 一 定 要 确定 必须 使 用 此 种 类 型 的 情况 下 再 使 
用 ， 毕 竟 Redis 是 键 值 对 模式 ，Hash 又 在 Redis 的 值 中 保存 了 键 值 对 ， 这 种 方式 如 果 不 能 熟练 
使 用 的 话 ， 是 很 容易 用 错 的 。 


12.3.4 Set 操作 


AQ Redis 的 Set 可 以 保存 集合 数据 ， 集 合 数据 的 唯一 性 在 Redis 中 也 是 支持 的 。 如 果 理 
解 集合 的 话 ， 那 么 使 用 Redis 的 Set 也 非常 简单 ， 只 要 熟悉 其 写法 即 可 。 下 面 列 出 Redis 的 Set 
常用 方法 : 
members: 获取 集合 中 的 元 素 。 

add: 向 集合 中 添加 数据 。 

remove: 移 除 集合 中 的 数据 。 

size: 获取 集合 中 元 素 的 个 数 。 
isMember: 判断 集合 中 是 否 包含 某 数据 。 


> 


a 
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E intersect: 集合 间 求 交集 。 
E union: 
加 unionAndStore: 集合 间 求 并 集 ， 并 且 保 存 到 另 一 个 集 
E difference: 计算 两 个 集合 的 差 集 。 


集合 间 求 并 集 。 


up 


加 randomMember: 获取 集合 中 的 随机 元 素 。 
代码 如 下 : 


@Override 
public void testRedisSet() { 


j 


redisTemplate.opsForSet().add("Set:set1", "set value 1","set value 2","set value 3"); 
Set<String> set = redisTemplate.opsForSet().members("Set:set1"); 
System.out.println(set.toString()); 

redisTemplate.opsForSet().add("'Set:set1", "set value 1"); 
redisTemplate.opsForSet().remove("Set:set1", "set value 3"); 

set = redisTemplate.opsForSet().members("Set:set 1"); 

System. out.println(set.toString()); 


redisTemplate.opsForSet().add("Set:set2", "set value 2","set value 3","set value 4"); 

System.out.println("set 2 size is " + redisTemplate.opsForSet().size(""Set:set2")); 

System.out.println("'set value 4 is member " + 
redisTemplate.opsForSet().isMember("Set:set2", "set value 4")); 


set = redisTemplate.opsForSet().intersect("Set:set1", "Set:set2"); 
System. out.println(set.toString()); 


set = redisTemplate.opsForSet().union("Set:set1", "Set:set2"); 
System. out.println(set.toString()); 


redisTemplate.opsForSet().unionAndStore("Set:set1", "Set:set2","Set:set3"); 
set = redisTemplate.opsForSet().members("Set:set3"); 
System. out.println(set.toString()); 


set = redisTemplate.opsForSet().difference("Set:set1", "Set:set2"); 
System. out.println(set.toString()); 


for(int i = 0; i<3; i++) { 
String member = redisTemplate. opsForSet().randomMember("Set:set2"); 
System.out.printIn("random member is " + member); 


} 


Set<String> setkeys = redisTemplate.keys("Set*"); 
redisTemplate.delete(setkeys); 


运行 结果 如 下 : 

[set value 2, set value 3, set value 1] 

[set value 2, set value 1] 

set 2 size is 3 

set value 4 is member true 

[set value 2] 

[set value 2, set value 3, set value 1, set value 4] 
[set value 2, set value 3, set value 1, set value 4] 
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[set value 1] 

random member is set value 3 
random member is set value 3 
random member is set value 4 


且 通 过 这 两 个 集合 进行 交集 、 并 集 、 差 集 的 操作 ， 并 集 操 作 通 过 unionAndStore 方法 保 


存 到 了 另 一 个 集合 ， 交 集 等 操作 也 有 类 似 方法 ， 这 里 就 不 再 演示 。 


12.3.5 


ZSet 操作 


ZSet 和 Set 的 区 别 在 于 ZSet 是 有 序 的 ，ZSet 中 的 数据 通过 一 个 排序 值 进行 排序 ， 并 且 可 


以 通过 排序 值 来 获取 ZSet 中 的 元 素 。ZSet 主要 方法 如 下 : 


Madd: 问 集合 中 添加 数据 。 
E scan: 获取 游标 。 
M range: 获取 茶 区 间 的 数据 。 
E incrementScore: 对 集合 中 的 排序 值 进行 操作 。 
M rank: 获取 集合 中 某 个 值 的 位 置 。 
E rangeByScore: 根据 排序 值 获取 集合 中 的 数据 。 
E count: 获取 某 个 区 间 的 集合 数据 的 个 数 。 
E removeRangeByScore: 根据 排序 值 移 除 集合 中 的 数据 。 
代码 如 下 : 
@Override 
public void testRedisZSet() { 
redisTemplate.opsForZSet().add("ZSet:set1", "set value 1", 1.0); 
redisTemplate.opsForZSet().add("ZSet:set1", "set value 2", 2.0); 
redisTemplate.opsForZSet().add("ZSet:set1", "set value 4", 4.0); 
Cursor<TypedTuple<String>> cursor = redisTemplate.opsForZSet().scan("ZSet:set1", ScanOptions. 
NONE); 


while (cursor.hasNext()) { 
TypedTuple<String> item = cursor.next(); 
System.out.printIn(item.getValue()); 
} 
redisTemplate.opsForZSet().add("ZSet:set1", "set value 3", 3.0); 
Set<String> retSet = redisTemplate.opsForZSet().range("ZSet:set1", 0, —1); 
System.out.println(retSet.toString()); 


redisTemplate.opsForZSet().incrementScore("ZSet:set1", "set value 1", 1.0); 
redisTemplate.opsForZSet().incrementScore("ZSet:set1", "set value 2", -1.0); 
retSet = redisTemplate.opsForZSet().range("ZSet:set1", 0, -1); 
System.out.println(retSet.toString()); 


Long index = redisTemplate.opsForZSet().rank("ZSet:set1", "set value 1"); 
System.out.println("set value 1 index is " + index); 


retSet = redisTemplate.opsForZSet().rangeByScore("ZSet:set1", 2.0, 4.0); 
System.out.println(retSet.toString()); 


Long count = redisTemplate.opsForZSet().count("ZSet:set1", 2.0, 4.0); 
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System.out.println("count is " + count); 


redisTemplate.opsForZSet().removeRangeByScore("ZSet:set1", 3.0, 4.0); 
retSet = redisTemplate.opsForZSet().range("ZSet:set1", 0, —1); 
System.out.println(retSet.toString()); 


Set<String> zsetkeys = redisTemplate.keys("ZSet*"); 
redisTemplate.delete(zsetkeys); 


} 
运行 结果 如 下 : 
set value 1 
set value 2 
set value 4 
[set value 1, set value 2, set value 3, set value 4] 
[set value 2, set value 1, set value 3, set value 4] 
set value | index is 1 
[set value 1, set value 3, set value 4] 
count is 3 
[set value 2, set value 1] 


上 面 的 代码 中 ， 通 过 游标 的 方式 遍历 集合 和 通过 区 间 的 方式 获取 集合 ， 都 能 得 到 一 组 有 序 
的 数据 ，incrementScore 方法 可 以 对 排序 值 进行 增 减 ， 增 减 后 集合 自动 排序 ，rank 方法 获取 某 
个 值 在 集合 中 的 位 置 ， 默 认 顺 序 从 小 到 大 ， 返 回 0 是 表示 第 一 个 数据 ， 注 意 rangeByScore 的 
取 值 区 间 是 封闭 的 。 


a 


12.4 Redis 事务 处 理 


当 要 一 次 批量 地 对 Redis 进行 很 多 操作 的 时 候 ， 或 者 在 操作 Redis 某 个 值 的 时 候 不 希望 其 
他 程序 对 这 个 值 进行 改变 ， 就 需要 用 到 Redis 的 事务 处 理 。 


12.4.1 批量 操作 
请 先 阅读 下 面 的 代码 ， 然 后 根据 代码 输出 的 耗 时 时 间 思 考 Redis 的 性 能 问题 。 


@Override 
public void testRedisMulti() { 
long starttime = System.currentTimeMillis(); 
for(int 1=0;i<1000;i++) { 
redisTemplate.opsForValue().set("String:Strings A:" + i, "strings " + i); 


H 


} 


long endtime = System.currentTimeMillis(); 
System.out.println("duration is " + (endtime-starttime)); 


starttime = System.currentTimeMillis(); 
Map<String, String> map = new HashMap<String, String>(); 
for(int 1=0;i<1000;i++) { 
map.put("String:Strings B:" + i, "strings "+ i); 
j 


redisTemplate.opsForValue().multiSet(map); 
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endtime = System.currentTimeMillis(); 
System.out.println("duration is " + (endtime-starttime)); 


starttime = System.currentTimeMillis(); 
redisTemplate.setEnableTransactionSupport(true); 
redisTemplate.multi(); 
for(int 1=0;i<1000;i++) { 
redisTemplate.opsForValue().set("String:Strings C:" + i, "strings " + i); 


redisTemplate.exec(); 
endtime = System.currentTimeMillis(); 
System.out.println("duration is " + (endtime-starttime)); 


Set<String> stringkeys = redisTemplate.keys("String*"); 
redisTemplate.delete(stringkeys); 
j 


行 结果 如 下 : 


duration is 5443 
duration is 16 
duration is 56 


第 一 种 方法 最 耗 时 ， 因 为 用 for 循环 的 方式 对 redis 操作 了 1000 次 ， 而 且 演示 环境 访问 的 
是 外 网 的 Redis， 大 部 分 时 间 浪 费 在 了 网 络 上 ; 第 二 种 方法 最 省 时 ， 因 为 虽然 向 Redis 中 添加 
了 1000 条 数据 ， 但 其 实 只 是 执行 了 一 次 Redis 操作 ;第 三 种 方法 使 用 批量 提交 的 方式 ， 所 以 
节省 了 大 量 的 网 络 时 间 ， 但 是 Redis 的 操作 次 数 没 有 变化 ， 所 以 耗 时 比 第 二 种 方法 要 长 一 些 。 
在 使 用 Redis 时 一 定 要 注意 使 用 方法 ， 完 成 同样 的 工作 使 用 不 同 的 方法 耗 时 是 有 明显 区 别 的 。 


12.4.2 ”对 值 进行 监控 


假设 程序 通过 Redis 的 某 个 键 值 对 记录 了 当前 系统 的 某 一 数值 ， 有 多 个 服务 实例 都 可 以 访 
问 这 个 键 值 。 这 会 出 现 一 个 问题 ， 当 其 中 一 个 实例 通过 一 系列 计算 要 设置 这 一 键 值 时 ， 其 他 程 
序 可 能 在 第 一 个 实例 计算 期 间 已 经 修改 了 这 个 原始 键 值 ， 这 样 第 一 个 实例 再 设置 这 个 键 值 可 能 
会 发 生 错 误 。 这 时 就 用 到 了 watch 方法 ， 它 可 以 监控 一 个 值 的 变化 。 


@Override 

public void testRedisTransaction() { 
redisTemplate.opsForValue().set("watchvalue", "1"); 
redisTemplate.setEnableTransactionSupport(true); 
redisTemplate.watch("watchvalue"); 
redisTemplate.multi(); 
redisTemplate.opsForValue().getAndSet("Wwatchvalue", "3"); 
List<Object> list = redisTemplate.exec(); 
System.out.println(list.toString()); 


} 

正常 执行 输出 为 : 
[1] 

中 途 值 被 修改 时 输出 为 : 
i 
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在 上 面 的 方法 中 ， 如 果 在 watch 之 后 ， 其 他 程序 修改 了 watchvalue 中 的 值 ， 那 么 Redis 操 
作 将 执行 失败 。 可 以 根据 exec 的 返回 值 判断 程序 是 否 执行 成 功 。 如 果 此 代码 是 属于 不 可 失败 
的 代码 ， 那 么 可 以 放 入 While 循环 中 监控 返回 值 ， 直 到 执行 成 功 为 止 。 


a 


12.5 Redis 分 布 式 锁 


一 个 程序 内 可 以 有 很 多 个 线程 ， 同 一 程序 内 的 众多 线程 访问 公共 资源 时 需要 加 锁 。 但 是 一 
个 系统 集群 内 的 众多 程序 要 访问 同一 公共 资源 时 ， 应 该 怎么 限制 多 个 程序 的 共同 访问 呢 ? 分 布 
式 锁 就 是 解决 此 问题 的 。 实 现 分布 式 锁 的 能 力 可 以 借用 多 种 工具 ， 这 里 介绍 使 用 Redis 实现 分 
布 式 锁 的 办 法 。 
代码 如 下 : 


@Repository 
public class RedisLock { 
@Autowired 
private RedisTemplate<String, String> redisTemplate; 
private String lockKey = "redislock"; 
private volatile boolean locked = false; 
private int expireMsecs = 10 * 1000; 
private int timeoutMsecs = 2 * 1000; 
private static final int DEFAULT ACQUIRY RESOLUTION MILLIS = 50; 


Am 


上 


H 


public boolean Lock() throws InterruptedException { 
int timeout = timeoutMsecs; 
int index = 0; 
Random random = new Random(); 
while (timeout > 0) { 
System. out.println(Thread.currentThread().getName() + 
" index value = " + (++index)); 
long expires = System.currentTimeMillis() + expireMsecs + 1; 
String expiresStr = String. valueOf(expires); 
if (redisTemplate.opsForValue().setIfA bsent(lockKey, expiresStr)) { 
System.out.printIn(Thread.currentThread().getName() + " locked setIfAbsent"); 
locked = true; 
return true; 


j 


String currentValueStr = redisTemplate.opsForValue().get(lockKey); 
if (currentValueStr != null 
&& Long.parseLong(currentValueStr) < System.currentTimeMillis()) { 
String old ValueStr = redisTemplate.opsForValue().getAndSet(lockKey, expiresStr); 
if (oldValueStr != null && oldValueStr.equals(currentValueStr)) { 
System.out.println(Thread.currentThread().getName() + 
"locked getAndSet"); 
locked = true; 
return true; 
} 
} 
int temp = random.nextInt( DEFAULT _ACQUIRY RESOLUTION MILLIS); 
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timeout -= temp; 


Thread. sleep(temp); 
} 


return false; 


} 


public void unLock() { 
if (locked) { 
System. out.printIn(Thread.currentThread().getName() + " unlock"); 
locked = false; 
redisTemplate.delete(lockKey); 


j 


public void success() { 
redisTemplate.opsForList().rightPush("redislocksuccesslist", 
Thread.currentThread().getName()); 
} 


public void fail() { 
redisTemplate.opsForList().rightPush("redislockfaillist", 
Thread.currentThread().getName()); 


j 
上 面 的 代码 中 ， 主 要 包含 4 个 方法 。Lock 方法 是 获取 分 布 式 锁 ， 如 果 获 取 成 功 会 返 

true。 这 里 分 布 式 锁 的 实现 主要 依靠 Redis 的 setIfAbsent 方法 ， 由 于 此 方法 只 能 在 Redis 中 没 

有 此 刍 值 时 才能 写 入 ， 所 以 可 以 写 入 的 程序 就 获得 了 锁 。 当 然 方法 中 添加 了 特殊 情况 的 补救 逻 

辑 和 超时 逻辑 ， 并 且 重新 尝试 获取 锁 的 时 间 间 隔 使 用 了 随机 数 ，unLock 方法 是 释放 锁 ， 当 某 

个 程序 已 经 执行 完 既 定 的 操作 ， 使 用 此 方法 释放 ， 即 删除 Redis 锁 使 用 的 键 值 。success 和 fail 

仅 作 为 测试 统计 用 ， 并 无 实际 意义 。 

看 一 段 测试 代码 : 
@RunWith(SpringRunner.class) 
@SpringBootTest 
public class RedisExampleApplicationTests { 


@Autowired 
private RedisLock redisLock; 


I 


private void redisDoSmth() { 


try { 
if(redisLock.Lock()) { 
System.out.println(Thread.currentThread().getName() + " do some thing"); 
redisLock.unLock(); 
redisLock.success(); 
yelse { 
System.out.printIn(Thread.currentThread().getName() + " get lock fail"); 
redisLock. fail(); 
} 
} catch (Exception e) { 
e.printStackTrace(); 
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} 


(实际 项 目 中 ， 


辑 的 程序 。 每 个 程序 抢占 分 布 式 锁 ， 


} 


@Test 
public void testRedisLock() { 
ExecutorService eService = Executors.newFixedThreadPool(50); 
for (int i = 0; i < 50; i++) { 
eService.execute(new Runnable() { 


@Override 
public void run() { 
redisDoSmth(); 
} 
J) 
} 
eService.shutdown(); 
try { 
Thread.sleep(20000); 
} catch (Exception e) { 
e.printStackTrace(); 
j 


同一 程序 内 的 锁 个 要 用 此 方法 )， 所 以 这 里 可 以 把 线程 想 


ii 


加 进 失 败 队列 。 


12.6 Redis 实现 秒杀 
秒杀 就 是 在 众多 请 求 同 时 发 起 时 ， 尽 量 划 选 出 既定 数目 的 头 几 个 请 求 作为 成 功 的 请 求 。 
面 用 Redis 实现 一 段 秒杀 程序 。 


@Repository 
public class RedisSecKill { 
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@Autowired 
private RedisTemplate<String, String> redisTemplate; 


private static final int TOTALCOUNT = 10; 


public void redisSecKill() { 
Long ranking = OL; 
int index = 0; 
System.out.println(Thread.currentThread().getName() + 

" redisSecKill start************"); 

boolean type = false; 
long starttime = System.currentTimeMillis(); 
redisTemplate.setEnableTransactionSupport(true); 
List<Object> list = null; 
try { 


DUT LS + WARE SAMUS SEE TAA 


1) 


由 于 服务 器 资源 有 限 ， 所 以 上 面 的 测试 方法 中 ， 使 用 多 线程 的 方式 模拟 多 个 程序 的 抢占 
象 为 已 经 实现 了 同步 多 


> 


否则 添 
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while(list == null || list.size()==0 || (Long)list.get(0)==0) { 
System.out.println(Thread.currentThread().getName() + 
" redisSecKill index value = " + (++index)); 
long now = System.currentTimeMillis(); 
long costTime = now ~ starttime; 
if(costTime > 1000) { 
System. out.println(Thread.currentThread().getName() + 
" redisSecKill timeout break*********"); 
type = false; 
break; 
} 
String temp = redisTemplate.opsForValue().get("redisSecKill"); 
if(Long.valueOf(temp)>=TOTALCOUNT) { 
System.out.printIn(Thread.currentThread().getName() + 
" redisSecKill out total break*********"); 
type = false; 
break; 
} 
redisTemplate.watch("redisSecKĶKill"); 
redisTemplate.multi(); 
redisTemplate.opsFor Value().increment("redisSecKill", 1); 
redisTemplate.opsFor Value().get("redisSecKill"); 
//Thread.sleep(20); 
list = redisTemplate.exec(); 
costTime = now ~- starttime; 
System.out.println(Thread.currentThread().getName() + 
" costime =" + costTime); 
} 
} catch (Exception e) { 
System.out.printin(e); 


} 


if(list!=null && list.size()>0) { 

String temp = (String)list.get(1); 
ranking = Long.valueOf(temp); 
if(ranking>TOTALCOUNT) { 

System.out.printIn(Thread.currentThread().getName() + 

" not ok and value =" + ranking); 

type = false; 
yelse { 

type = redisTemplate.opsForValue().setIfA bsent("redisSecKill success:" + 

ranking, Thread.currentThread().getName()); 


j 
j 
if(type) { 
System.out.println(Thread.currentThread().getName() + " redisSecKill ok"); 
redisTemplate.opsForList(). 
rightPush("redisSecKiullList",Thread.currentThread().getName()); 
yelse { 
System.out.println(Thread.currentThread().getName() + " redisSecKill fail"); 
j 
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} 
} 


没有 立刻 返回 秒杀 结果 ， 仪 把 秒杀 成 功 的 请 求 放 到 一 个 队列 中 。 


在 上 面 的 代码 中 ， 只 包含 一 个 方法 ， 就 是 秒杀 的 业务 逻辑 ， 由 于 用 于 演示 ， 所 以 这 个 方法 


此 段 代 码 的 主要 风 辑 就 是 首先 对 一 个 值 进 行 计数 加 1 和 获取 当前 计数 的 操作 ， 然 后 把 此 事 


务 得 到 的 结果 使 用 setlfAbsent 方法 写 入 一 个 值 中 ， 如 果 可 以 写 入 则 确认 此 排名 成 功 ， 并 把 成 


功 的 请 求 计 入 成 功 队列 。 当 然 方法 中 包含 一 些 噶 常 逻 辑 的 处 理 ， 这 里 就 不 过 多 介绍 。 


以 上 程序 的 测试 代码 如 下 : 
@RunWith(SpringRunner.class) 
@SpringBootTest 
public class RedisExampleApplicationTests { 

@Autowired 
private RedisSecKill redisSecKall; 


@Test 
public void testSecKill() { 
ExecutorService eService = Executors.newFixedThreadPool(50); 
for (int i = 0; i < 50; i++) { 
eService.execute(new Runnable() { 
@Override 
public void run() { 
redisSecKill redisSecKull(); 
} 
J) 
eService.shutdown(); 
try { 
Thread.sleep(20000); 


} catch (Exception e) { 
e.printStackTrace(); 


j 
j 


秒杀 成 功 。 
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查看 哪些 线程 


在 这 段 代 码 中 ， 也 是 用 一 个 线程 指 代 一 个 服务 ， 多 线程 则 表示 多 服务 实例 抢占 。 在 测试 前 
JETE Redis 中 添加 键 值 对 redisSecKill 为 0。 测 试 完成 后 ， 可 以 在 秒杀 成 功 队 列 


第 13 瘟 Zookeeper 


Zookeeper 从 英文 直译 是 “动物 管理 员 ”。 各 个 系统 就 好 比 动物 园 里 的 动物 ， 为 了 使 各 个 系 
统 能 正常 提供 统一 的 服务 ， 必 须 用 一 种 机 制 来 进行 协调 ， 这 就 是 ZooKeeper 的 作用 。 


13.1 Zookeeper 介绍 


Zookeeper9 是 一 个 开放 源码 的 分 布 式 应 用 程序 协调 服务 ， 是 为 分 布 式 应 用 提供 一 致 性 服务 
的 软件 ， 提 供 的 功能 包括 : 配置 维护 、 命 名 服务 、 分 布 式 同步 、 组 服务 等 。Zookeeper 是 用 
Java 语言 开发 的 ， 提 供 Java 和 C 语言 的 客户 端 API. 
Zookeeper 的 集群 模式 为 290+19 个 服务 (奇数 )， 只 允许 n 个 失效 。Zookeeper 集群 服务 有 
Leader、Follower、Observer 三 个 角色 。 
E Leader: 提供 写 服务 ， 针 对 Zookeeper 进行 数据 更 新 相关 操作 。 
E Follower: 提供 读 服 务 ，Leader 宕 机 后 会 在 Follower 中 重新 选举 新 的 Leader. 
E Observer: 是 一 种 新 型 的 Zookeeper 节点 ， 不 参与 投票 ， 只 是 简单 地 接收 投票 结果 ， 
加 再 多 的 Observer， 也 不 会 影响 集群 的 写 性 能 。 除 了 这 个 差别 ， 其 他 方面 和 Follower 
基本 上 一 样 。 
Zookeeper 结构 是 由 znode 节点 组 成 的 树 形 结构 。 格 式 类 似 分 层 的 文件 目录 树 形 式 ， 每 个 
节点 可 以 存放 数据 ， 也 可 以 有 子 节点 。 节 点 的 访问 路 径 为 绝对 路 径 ， 不 存在 相对 路 径 。 
znode 节点 根据 存活 时 间 ， 分 为 持久 节点 和 临时 节点 。 节 点 的 类 型 在 创建 时 就 确定 下 来 ， 
并 且 不 能 改变 。 
国 持久 节点 的 存活 时 间 不 依赖 于 客户 端 会 话 ， 只 有 客户 端 在 显 式 执行 删除 节点 操作 时 ， 
节点 才 消 失 。 
图 | 佛 时 节点 的 存活 时 间 依 赖 于 客户 端 会 话 ， 当 会 话 结束 ， 临 时 节点 将 会 被 自动 删除 〈 当 
然 也 可 以 手动 删除 临时 节点 )。ZooKeeper 中 临时 节点 不 能 拥有 子 节点 。 
Zookeeper 的 应 用 场景 是 : 
E 分 布 式 命名 服务 : 按 名 称 标 识 集群 中 的 节点 。 
E 数据 发 布 与 订阅 : 应 用 启动 时 主动 获取 配置 信息 ， 并 在 节点 上 注册 一 个 观察 者 
(watcher)， 每 次 配置 更 新 都 会 通知 到 应 用 。 
加 分 布 式 通知 /协调 : 不 同 的 系统 都 监听 同一 个 节点 ， 一 旦 有 了 更 新 ， 另 一 个 系统 能 够 收 
到 通知 。 
图 分 布 式 锁 : Zookeeper 能 保证 数据 的 强 一 致 性 ， 用 户 任何 时 候 都 可 以 相信 集群 中 每 个 节 


© Zookeeper 的 官网 是 http:/zookeeper.apache.org/。 

© Zookeeper 集群 中 只 要 有 过 半 的 机 器 正常 工作 ， 就 是 可 用 的 。 例 如 集群 有 2 个 Zookeeper 节点 ， 那 么 只 要 有 1 个 宕 机 ， 
Zookeeper 就 不 能 用 ， 因 为 1 没有 过 半 ，2 个 Zookeeper 的 宕 机 容忍 度 为 0; 同 理 ， 集 群 有 3 个 Zookeeper Wi, SEV, RF 2 个 
正常 的 ， 过 半 了 ， 所 以 3 个 Zookeeper 的 容忍 度 为 1; 多 列举 几 个 : 2->0;3->1;4->1;5->2;6->2， 会 发 现 一 个 规律 ，2n 和 2n-1 的 容忍 
度 是 一 样 的 ， 都 是 n-1。 多 出 一 台 用 处 不 大 ， 所 以 集群 总 数 为 奇数 。 
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点 的 数据 都 是 相同 的 。 


E 集群 管理 : 服务 加 入 集群 时 创建 一 个 节点 ， 写 入 当前 服务 的 状态 。 监 控 父 节点 的 应 用 会 
收 到 通知 ， 进 行 相应 的 处 理 。 离 开 时 删除 节点 ， 监 控 节 点 的 应 用 同样 也 会 收 到 通知 。 


13.2 基本 操作 


下 面 介绍 如 何 使 用 Zookeeper 自 带 客户 端 以 及 Java 客户 端 进行 Zookeeper 的 相关 数据 操作 。 
登录 Zookeeper 官网 https://zookeeper.apache.org/releases.html 下 载 ZooKeeper 压缩 包 ， 本 


书 编写 时 ， 最 新 的 稳定 版 本 为 3.4.10。 下 载 后 解压 到 本 机 。Zookeeper 核心 目录 以 及 含义 见 


表 13-1. 
表 13-1 Zookeeper 核心 目录 
目录 名 称 内 a 说 明 
a _ Zookeeper 的 可 执行 脚本 目 录 ， 包括 zk 服务 进程 ，Zookeeper 客户 端 等 脚本 。 其 中 ，.sh 是 Linux 环境 
下 的 脚本 ，.cmd 是 Windows 环境 下 的 脚本 
conf 配置 文件 目录 。zoo_sample.cfg 为 样 例 配 置 文件 ， 需 要 修改 为 自己 的 名 称 ， 一 般 为 zoo.cfg 
lib Zookeeper 依赖 的 包 
contrib 些 用 于 操作 Zookeeper 的 工具 包 
docs Zookeeper 的 使 用 帮助 手册 
recipes Zookeeper 某 些 用 法 的 代码 示例 


13.2.1 Zookeeper 客户 端 操作 
进入 Zookeeper 解压 文件 的 bin 目录 ， 使 用 zkCli 客户 端 来 学 习 Zookeeper 相关 的 命令 操 
作 。 这 里 以 Linux 服务 器 环境 为 例 进行 讲解 ， 如 果 当 前 为 Windows 环境 ， 打 开 cmd 命令 行 执 
行 相应 的 .cmd 后 缀 命令 即 可 。 
图 启动 Zookeeper 服务 : 
$ ./zkServer.sh start 


a 查看 有 


RS KAS, GT RA: 


$./zkServer.sh status 


m 停止 月 
$./zk 


及 务 : 


Server.sh stop 


mad 


及 务 : 


$ ./zkServer.sh restart 


图 启动 客户 端 ， 通 过 -server 指定 连接 的 服务 地 址 及 端 


$ ./zkCli.sh -server 127.0.0.1:2181 
E 进入 客户 端 后 ， 用 ls 命令 查看 节点 信息 : 
ls /path 
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图 创建 节点 ， 指 令 格式 为 : 


创 


创 


create [~s] [~e] 


path data acl 


建 节点 /zkpath， 并 存放 数据 zkDatas; 


create /zkpath "zkDatas" 
建 临时 节点 ,需要 使 用 参数 ~e; 


create -e /temp 


datas 


创建 有 序 节 点 ,需要 使 用 参数 -s: 


create =s /sequ- datas 


加 获取 节点 内 容 。get 命令 获取 一 个 节点 存储 的 数据 内 容 ， 同 时 可 获取 该 节点 的 stat 信 
息 。znode 的 stat 字段 含义 见 表 13-2- 


表 13-2 stat 信息 
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字 段 名 E AX 
cZxid 创建 节点 事务 的 zxid? 
ctime 表示 znode 的 创建 时 间 
mZxid znode 最 近 修 改 的 zxid 
mtime 表示 mode 最 近 修 改 的 时 间 
pZxid 该 节点 或 子 节点 的 最 近 一 次 创建 或 删除 zxid 
cversion Znode 子 节 点 修改 次 数 
dataVersion Znode 节点 数据 修改 次 数 
aclVersion znode 的 ACL 修改 次 数 
ephemeralOwner 如 果 znode 是 临时 节点 ， 则 指示 节点 所 有 者 的 会 话 ID; 如 果 不 是 临时 节点 ， 则 为 零 
dataLength znode 数据 长 度 
numChildren 当前 节点 包含 的 子 节 点 个 数 


例如 ， 获 取 /zkpath 数据 信息 : 


get /zkpath 


8 结果 为 : 


"zkDatas" 
cZxid = 0xlc5 


ctime = Tue May 22 12:14:05 CST 2018 


mZxid = 0x1c5 


mtime = Tue May 22 12:14:05 CST 2018 


pZxid = 0xlc5 
cversion = 0 


© zxid: ZooKeeper 状态 的 每 一 次 改变 ， 都 对 应 着 一 个 递增 的 Transaction id, It id 称 为 zxid。 
zxidl 小 于 zxid2， 那 么 zxidl 肯定 先 于 zxid2 发 生 。 创 建 任意 节点 或 者 更 新 任意 节点 的 数据 或 者 删除 任 
状态 发 生 改变 ， 从 而 导致 zxid 


的 值 增加 。 


于 zxid 的 递增 性 质 ， 如 果 
意 节 点 ， 都 会 导致 Zookeeper 
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data Version = 0 
aclVersion = 0 


ephemeralOwner = 0x0 


dataLength = 9 
numChildren = 0 


可 以 看 出 通过 get 方法 返回 了 znode 信息 。 
图 修改 /zkpath 节点 数据 : 
set /zkpath "zkDatasupdate" 


MGT. delete 命令 可 以 用 于 删除 一 个 节点 ， 


例如 ， 删 除 /zkpath 节 


delete /zkpath 


E quit 命令 退出 当前 客户 端 ; 


quit 


但 它 只 能 删除 没 


De 


ae 


图 执行 help 命令 ， 可 查看 更 多 命令 : 
[zk: 127.0.0.1:2181(CONNECTED) 2] help 
ZooKeeper -Server host:port cmd args 


stat path [watch] 


set path data [version] 


ls path [watch] 


delquota [-n|-b] path 


ls2 path [watch] 
setAcl path acl 


setquota —n|-b val path 


history 
redo cmdno 


printwatches on|off 
delete path [version] 


Sync path 
listquota path 
mmr path 

get path [watch] 


create [~s] [~e] path data acl 
addauth scheme auth 


quit 
getAcl path 
close 


connect host:port 


13.2.2 Java 客户 端 操作 Zookeeper 


SI 


Zookeeper 客户 端 


| 


是 供 了 基本 的 操作 ， 但 是 有 许多 不 足 之 处 ， 例 如 


重 试 机 制 ， 无 法 级 联 删除 ， 
其 在 Zookeeper 原 
、 节 点 


次 性 的 Watcher 机 制 等 ， 


© 网 址 是 http://mvnrepository.com/artifact/com.101tec/zkclient. 
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其 Session 超时 后 没有 


因此 平时 业务 


发 第 


有 客户 端 基础 上 进行 了 封装 ， 实 现 了 Watcher 反复 注册 、Session 
点 级 联 删除 等 功能 。 


| ZkClientO FF} 


有 任何 子 节 点 的 节点 。 


ZAN 


ay 


CH 
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ANT. 


a 


z 

& 
inant 
tit 


本 节 使 用 Spring Boot 工程 来 操作 Zookeeper. # 
如 下 操作 。 
C1) 添加 组 件 依赖 


<dependency> 
<groupId>com.101tec</groupId> 
<artifactId>zkclient</artifactld> 
<version>0.10</version> 
</dependency> 


(2) 添加 Zookeeper 的 配置 信息 至 yml XH 


server: 

port: 18094 
spring: 

application: 

name: zookeeper-example 

zk: 

address: 127.0.0.1:2181 

connectionTimeout: 5000 


时 ZookeeperExample， 然 后 进行 


TT 


(3) Zookeeper 配置 注入 
编写 一 个 ZookeeperModel 类 ， 用 于 注入 ym 文人 


@Component 
@ConfigurationProperties(prefix="zk") 


my 


中 的 配置 信息 。 


public class ZookeeperModel { 
/** 服务 嚣 地址 列表 */ 
private String address; 
pE 

private int connectionTimeout; 

// 省 上 略 getset 方法 

} 


(4) 添加 Zookeeper 基本 操作 
在 工程 内 ， 新 建 ZookeeperDao 接口 和 它 的 实现 类 ， 简 单 实现 Zookeeper 的 增删 改 查 
操作 。 


public interface ZookeeperDao { 
public void testZkCRUDQ); 
public void test WathChildChange(); 
public void testDataChanges(); 


j 


@Component 
public class ZookeeperDaoImpl implements ZookeeperDao{ 
@Autowired 
private ZookeeperModel zookeeperModel; 
public void testZkCRUD(Q { 
String address = zookeeperModel.getAddress(); 
ZkClient zkClient = new ZkClient(address, zookeeperModel.getConnectionTimeout()); 
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String pathParant="/persis"; 

String child01Path=pathParant+"/child01"; 

String child02Path=pathParant+"/child02"; 

String ephemeral="/ephemeral"; 

ML, 创建 临时 有 序 节点 

String ephemeralSequential = zkClient. 
createEphemeralSequential("/ephemeralSequential—", "epheSequentialDatas"); 

String data4pathEph= zkClient.readData(ephemeralSequential); 

System.out.printin(String.format(" 临 时 有 序 节 点 路 径 为 ，%s, 数 据 为 : %s",ephemeral 


Sequential,data4pathEph)); 


ephemeralSequential = zkClient. 

createEphemeralSequential("/ephemeralSequential—", "epheSequentialDatas"); 
data4pathEph= zkChient.readData(ephemeralSequential); 
System.out.printin(String.format(" 临 时 有 序 节 点 路 径 为 ，%s, 数 据 为 : %s",ephemeral 


Sequential,data4pathEph)); 
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zkClient.createPersistent(child01 Path, true); 
boolean exists= zkClient.exists(child01 Path); 
if(exists) { 
System.out.println(String.format(" 节 点 :%s， 级 联 创建 成 功 ",child01Path)); 
} 
zkClient.createEphemeral(ephemeral); 
exists= zkClient.exists(ephemeral); 
if(exists) { 
System.out.printin(String.format(" 临 时 节点 :%s, 创建 成 功 ",ephemeral)); 
} 
//delete node 
zkClient.delete(ephemeral); 
zkClient.deleteRecursive(pathParant); 
exists= zkClient.exists(pathParant); 
System.out.println(String.format(" 节 点 %s, 是 否 存在 : %s",pathParant,exists)); 


/2. 创建 节点 以 及 子 节 点 

zkClient.createPersistent(pathParant, "rootDatas"); 

String data = zkClient.readData(pathParant); 
System.out.println(String.format(" 数 据 节 点 %s, 数 据 为 : %s",pathParant,data)); 
zkClient.createPersistent(child01Path, "datas of child01"); 
zkClient.createPersistent(child02Path, "datas of child02"); 


List<String> list = zkClient. getChildren("/persis"); 
for (String p : list) { 
System.out.println("child path is "+p); 
String path = pathParant +"/"+ p; 
data = zkClient.readData(path); 
System.out.println(String.format(" 数 据 节 点 :%s, 数 据 :%s",path,data)); 


} 


/3. 更 新 节点 数据 
boolean isExists=zkClient.exists(child01Path); 
System.out.println(String.format(" 数 据 节 点 %s, 是 否 存在 : %s",child01Path,isExists)); 
if(isExists) { 
data=zkClient.readData(child0 1 Path).toString(); 
System.out.printIn(String.format(" 数 据闻 点 %s, 数 据 为 ，%s",child01Path,data)); 
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zkClient.writeData(child01 Path, "update datas"); 
data=zkClient.readData(child0 1 Path).toString(); 
System.out.println(String.format(" 数 据 节点 %s, 数 据 为 : %s",childO1 Path,data)); 


j 

/递归 删除 节点 

zkClient.deleteRecursive(pathParant); 

exists = zkClient.exists(pathParant); 

System.out.println(String.format(" 节 点 %s, 是 否 存在 : %s",pathParant,exists)); 


省 略 其 他 两 个 方法 


上 面 的 代码 中 ， 使 用 ZkClient 对 Zookeeper 进行 操作 。 使 用 createEphemeralSequential 方 
法 创建 临时 有 序 节 点 ， 使 用 createPersistent 方法 创建 永久 节点 ， 方 法 exists 判断 节点 是 否 存 
在 ，readData 读 取 节 点 数据 ，writeData 写 入 节点 数据 ，deleteRecursive 级 联 删 除 节 点 等 。 
(5) 使 用 测试 类 进行 测试 
在 TestZKService 类 中 ， 添 加 如 下 测试 代码 ， 检 验 ZkClient 的 使 用 情况 。 
@RunWith(SpringRunner.class) 
@SpringBootTest(classes = ZookeeperExampleA pplication.class) 
public class TestZKService { 
@Autowired 
ZookeeperDao zookeeperDao; 
@Test 


public void testZkClient() throws Exception { 
zookeeperDao.testZkCRUD(); 


} 

} 

运行 结果 如 下 : 
临时 有 序 节点 路 径 为 : /ephemeralSequential-0000000084, 数 据 为 : epheSequentialDatas 
临时 有 序 节点 路 径 为 : /ephemeralSequential-0000000085, 数 据 为 : epheSequentialDatas 
节点 :/persis/child01， 级 联 创建 成 功 
临时 节点 :/ephemeral, 创建 成 功 
节点 /persis, 是 否 存 在 : false 
数据 节点 /persis, 数 据 为 : rootDatas 
child path is child02 
数据 节点 :/persis/child02, 数 据 :datas of child02 
child path is child01 
数据 节点 :/persis/child01, 数 据 :datas of child01 
数据 节点 /persis/child01, 是 否 存 在 : true 
数据 节点 /persis/child01, 数 据 为 :datas of child01 
数据 节点 /persis/child01, 数 据 为 :update datas 
节点 /persis, 是 否 存 在 : false 


注入 ZookeeperDao 类 的 实例 ， 然 后 调用 Dao 中 的 方法 ， 从 输出 可 见 操作 Zookeeper 中 的 
数据 结果 。 
13.2.3 订阅 子 节 点 变化 


ZkClient 的 subscribeChildChanges 方法 用 来 订阅 子 节 点 变化 ， 下 面 三 个 事件 会 触发 订阅 
通知 : 
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1) 新 增 子 节点 。 
2) 减少 子 节点 。 
3) 自身 节点 增删 。 


需要 注意 subscribeChildChanges 不 会 监听 节点 内 容 的 变化 。 


通过 ZookeeperDao 上 


具体 如 下 : 


PF 的 testWathChildChange 方法 来 演示 Zookeeper 监听 节点 变化 机 


public void testWathChildChange() { 


try{ 


String address = zookeeperModel.getAddress(); 
ZkClient zkChent = new ZkClient(new ZkConnection(address), 


zookeeperModel.getConnectionTimeout()); 


String parentPath="/persist"; 
boolean exists = zkClient.exists(parentPath); 


if(exists) { 


zkChient.deleteRecursive(parentPath); 


j 


zkClient.subscribeChildChanges("/persist", new IZkChildListener() { 
@Override 


public 


void handleChildChange(String parentPath, 
List<String> currentChilds) throws Exception { 


System.out.println(String.format(" 触 发 到 监听 事件 :parentPath %s, 


} 
n 


其 所 有 子 节点 : %s",parentPath,currentChilds)); 


zkClient.createPersistent(parentPath); 
Thread.sleep(1000); 

String child01Path=parentPath+"/child01"; 
zkClient.createPersistent(child01Path, "child01 datas"); 


System. out. 


println("———> create path: "+child01 Path); 


Thread.sleep(1000); 
String child02path=parentPath+"/child02"; 
zkClient.createPersistent(child02path, "child02 datas"); 


System. out. 


println("---+> create path: "+child02path); 


Thread.sleep(1000); 
zkClient.writeData(child02path,"update child02 datas"); 


System. out. 


println("———> update path:"+child02path); 


Thread.sleep(1000); 
zkClient.delete(child02path); 


System. out. 


println("———> delete path:"+child02path); 


Thread.sleep(1000); 
zkClient.deleteRecursive("/persist"); 


System.out.println("---—> delete path:/persist"); 
Thread.sleep(4* 1000); 
System. out.println("done"); 
}catch (Exception e) { 
e.printStackTrace(); 
j 


} 
运行 结果 如 下 : 
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13.2.4 


==> 


done 


触发 到 
触发 到 


到 监听 事件 :parentPath /persist， 其 所 有 子 节 点 : [|] 

create path: /persist/child01 
| 监听 事件 :parentPath /persist， 其 所 有 子 节点 : [child01] 
create path: /persist/child02 

监听 事件 :parentPath /persist， 其 所 有 子 节 点 : [child02, child01] 
update path:/persist/child02 

elete path:/persist/child02 
| 监听 事件 :parentPath /persist， 其 所 有 子 节点 : [child01] 
delete path:/persist 

监听 事件 :parentPath /persist, 其 所 有 子 节 点 : null 
监听 事件 :parentPath /persist, 其 所 有 子 节 点 : null 


订阅 市 各 的 数据 内 容 变化 


ZkClient 的 subscribeDataChanges 方法 用 来 订阅 节点 的 数据 内 容 变化 。 


通过 ZookeeperDao 中 的 testDataChanges 方法 来 演示 Zookeeper 的 监听 节点 数据 机 制 ， 有 具 
体 如 下 : 


public void testDataChanges() { 


try{ 


String address = zookeeperModel.getAddress(); 
ZkClient zkChient = new ZkClient(new ZkConnection(address), 
zookeeperModel.getConnectionTimeout()); 
String path="/persist"; 
if(zkClient.exists(path)) { 
zkClient.deleteRecursive(path); 
} 
zkChlient.createPersistent(path, datas"); 
/对 父 节 点 添加 监听 子 节点 中 数据 的 变化 
zkChent.subscribeDataChanges("/persist", new IZkDataListener() { 
@Override 
public void handleDataDeleted(String path) throws Exception { 
System.out.println(" 删 除 节 点 为 "+ path); 


} 


@Override 
public void handleDataChange(String path, Object data) throws Exception { 
System.out.println(String.format(" 变 更 节点 为 :%s， 
变更 内 容 为 :%s" ,path,data)); 


j 
J) 
Thread.sleep(1000); 
zkClient.writeData(path, "update datas 01", -1); 
System.out.println("———> write datas:"+path); 
Thread.sleep(1000); 


String child02path=path+"/child02"; 
zkClient.createPersistent(child02path, "child02 datas"); 
System.out.println("—--—> create child path:"+child02path); 
Thread.sleep(1000); 
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zkChent.writeData(child02path, "update child datas", -1); 
System.out.println('"---—> update child datas:"+ childO2path); 
Thread.sleep(1000); 


zkChent.writeData(path, "update datas 02", —1); 
System. out.println('"—--—> update datas:"+path); 
Thread.sleep(1000); 


zkClient.deleteRecursive(path); 
System.out.println("---—> delete path:"+path); 
Thread.sleep(2* 1000); 
}catch (Exception e) { 
e.printStackTrace(); 
} 
} 


运行 结果 如 下 : 
一 -> write datas:/persist 
变更 节点 为 :persist， 变 更 内 容 为 :update datas 01 
———-> create child path:/persist/child02 
———-> update child datas:/persist/child02 
———-> update datas:/persist 
变更 节点 为 /persist， 变 更 内 容 为 :update datas 02 


一 -> delete path:/persist 
删除 节点 为 :persist 


从 上 面 的 结果 可 以 看 出 ， 当 /persist 节点 数据 发 生变 化 后 ， 才 会 触发 监听 ， 其 子 节点 数据 
的 变化 并 不 会 被 监听 到 。 


13.3 ”服务 注册 与 发 现 


根据 上 一 节 对 ZkClient 的 学 习 ， 实 现 一 个 简单 的 服务 注册 与 发 现 功能 。 实 现 思路 如 下 : 

E 服务 提供 方 在 启动 后 ， 在 Zookeeper 的 指定 父 路 径 下 注册 服务 ， 创 建 对 应 的 URL 临时 
节点 ， 并 将 自己 的 服务 名 、 卫 地 址 、 端 口 、 权 重 存 放 到 临时 节点 的 数据 中 。 

E 服务 调用 方 在 启动 服务 后 ， 到 Zookeeper 指定 父 路 径 下 找到 所 有 的 子 节点 的 数据 并 存放 
起 来 ， 订 阅 子 节点 变化 ， 以 便 随 时 更 新 提供 方 服务 列表 。 

m 当 提 供 方 出 现 宕 机 或 者 网 络 故 障 时 ， 它 对 应 的 URL 节点 在 sessionTimeOut 后 ， 就 会 被 
销毁 ， 此 时 临时 节点 会 删除 ， 触 发 调用 方 的 节点 监听 事件 ， 所 有 调用 方 都 会 收 到 节点 
变化 (watcher) 的 通知 ， 调 用 方 需要 更 新 提供 方 服务 列表 并 且 继 续 监 听 。 


13.3.1 服务 注册 


服务 提供 方 在 启动 后 ， 需 要 把 自身 的 服务 名 、IP、 端 口 、 权 重 等 信息 以 临时 有 序 节点 的 
式 存放 到 指定 的 父 节 点 下 面 ， 具 体 实现 如 下 : 


public class Constants { 


SN 


public static final String parentZnodePath = "/javadevmap-Servers"; 
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* 服务 提供 方 


@Service 
public class RemoteServer { 


private ZkClient zkClient = null; 
@Autowired 
ZookeeperModel zookeeperModel; 


@PostConstruct 
public void initMethod() { 
// 创建 zkclient 
zkClient = new ZkClient(zookeeperModel.getAddress(), 
zookeeperModel.getConnectionTimeout()); 


} 

per 

* 在 固定 节点 下 面 创 建 临时 有 序 节点 
w 


public void registerServer(String serverName, String address, String port) throws Exception { 
// 先 创建 出 父 节 点 ,用 于 被 调用 方 监听 
if (!zkClient.exists(Constants.parentZnodePath)) { 
zkClient.create(Constants.parentZnodePath, null, 
Ids.OPEN ACL UNSAFE, CreateMode.PERSISTENT); 


j 

Map<String,String> datas=new HashMap©(); 

datas.put("serverName",serverName); 

datas.put("host",address); 

datas.put("port",port); 

/ 服务 权重 0-100 

datas.put("weight",new Random().nextInt(100)+""); 

JSONObject jsonObject = JSONObject.fromObject(datas); 

String result = jsonObject.toString(); 

/在 指定 路 径 下 面 创 建 临时 节点 

String pathName = zkClient.create( 
Constants.parentZnodePath + "/" + serverName + "—", 
result, Ids. OPEN ACL UNSAFE, 
CreateMode.EPHEMERAL SEQUENTIAL); 

System.out.printIn("[Server]>>>>>>" + serverName + " is register success! pathName = 


Ta 


提供 方 服务 在 父 节 点 /javadevmap-Servers 下 面 创建 以 服务 名 称 开头 的 临时 节点 ， 在 此 临时 


节点 5 


运行 ， 


P 添 加 相应 的 服务 相关 信息 。 编 写 一 个 测试 类 TestRegisterDemo， 通 过 使 用 startRemote 
Server 方法 模拟 服务 提供 方程 序 ， 把 此 服务 注册 到 Zookeeper 上 ， 启 动 后 进行 等 待 来 模拟 服务 


H 


一 


体内 容 如 下 : 


@Autowired 

RemoteServer server; 

@Test 

public void startRemoteServer() throws Exception { 
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String serverName="orderServer"; 


String address="192.168.1."+new Random().nextInt(255); / FRI ip 

int port=1000+new Random().nextInt(599); /端口 在 1000-1599 之 间 
server.registerServer(serverName,address, port+""); / 广 册 服务 
System.out.println("[Server]>>>>>>" + serverName + " is Online ......"); 


Thread.sleep(Long. MAX VALUE); 


} 
运行 结果 如 下 : 
[Server]>>>>>>orderServer is register success! pathName = /javadevmap-Servers/orderServer—- 


0000000003 
[Server]>>>>>>orderServer is Online ...... 


13.3.2 ”服务 发 现 


服务 调用 方 在 启动 服务 后 ， 主 动 获取 指定 父 节 点 下 面 所 有 的 数据 ， 并 且 订 阅 子 节点 变化 事 
件 ， 在 此 事件 触发 后 ， 更 新 相应 的 服务 提供 方 列表 。 这 里 定义 RemoteCient 类 ， 来 实现 服务 调 
用 方 ， 有 具体 实现 如 下 : 
IEE 
* 服务 调用 方 
3 
@Service 
public class RemoteClient { 
private List<String> serList = null; 
private ZkClient zkClient = null; 


@Autowired 
ZookeeperModel zookeeperModel; 
@PostConstruct 
public void initMethod() { 
/ 构建 zkclient 
zkClient = new ZkClient(zookeeperModel.getAddress(), 
zookeeperModel.getConnectionTimeout()); 


} 


public void subscribeChildChanges4Servers() throws Exception { 
zkChent.subscribeChildChanges(Constants.parentZnodePath, new IZkChildListener() { 
@Override 
public void handleChildChange(String parentPath, List<String> currentChilds) 
throws Exception { 
System.out.println(String.format(" 一 > 触发 到 监听 事件 :parentPath %s, 
EHATE A: %s", parentPath, currentChilds)); 
updateServerList(currentChilds); 
System.out.println("<<<<<<<<<<<<<<<<<<<< |f IT AiR"); 


/[** 


* 主动 获取 server list 数据 
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Ez 
public void getServerList() throws Exception { 
System.out.printIn(">>>>>>>>>>>>>>>>>>"); 
/ 先 创建 出 父 节 点 ,用 于 被 调用 方 监听 
if (!zkClient.exists(Constants.parentZnodePath)) { 
zkClient.create(Constants.parentZnodePath, null, 
ZooDefs.Ids.OPEN ACL UNSAFE, CreateMode.PERSISTENT); 


} 
List<String> children = zkClient.getChildren(Constants.parentZnodePath); 
if (null = children || children.size() == 0) { 

return; 
} 
updateServerList(children); 
System.out.println("<<<<<<<<<<<<<<<<<<<<"); 


j 


private void updateServerList(List<String> currentChilds) { 

ArrayList<String> serverList = new ArrayList<String>(); 

for (String child : currentChilds) { 
String path = Constants.parentZnodePath + "/" + child; 
String data = zkClient.readData(path); 
serverList.add(new String(data)); 

j 

serList = serverList; 

/ 打印 更 新 后 的 服务 器 列表 信息 

for (String server : serverList) { 
System.out.println(String.format(" 服 务 数据 :%s",server)); 


} 


} 
在 TestRegisterDemo 类 中 添加 测试 方法 ， 模 拟 服务 调用 方 获取 3 
具体 如 下 : 


@Autowired 

RemoteClient client; 

@Test 

public void startRemoteClient()throws Exception { 
client.getServerList(); 
client.subscribeChildChanges4Servers(); 
Thread.sleep(Long. MAX VALUE); 


LT HRS HE TT A R 


| 


} 
如 果 上 一 节 的 服务 没有 停止 的 话 ， 启 动 客户 端 ， 能 够 获取 对 应 的 服务 列表 信息 ， 运 行 结果 
如 下 : 


服务 数据 : 
{"port":"1388","host":"192.168.1.100","serverName":"orderServer","weight":"30"} 

每 当 通过 测试 类 的 startRemoteServer 方法 启动 服务 提供 方程 序 时 ， 会 触发 服务 调用 方 子 节 
点 变化 事件 ， 服 务 调用 方 在 监听 事件 中 及 时 更 新 列表 数据 ， 当 停止 运行 startRemoteServer 方法 
关闭 服务 提供 方程 序 时 ， 服 务 调用 方 也 会 更 新 对 应 的 列表 数据 。 
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FastDFS 


要 一 个 稳定 、 易 扩容 、 高 可 月 


需 
实现 文件 储存 的 相关 操作 。 


14.1 FastDFS 基本 介绍 


FastDFS 是 一 个 


日 的 环境 。FastDFS 7 


F 在 服务 器 中 存储 时 ， 


开源 的 高 性 能 分 布 式 文件 


和 文件 访问 ， 有 具备 了 大 容量 和 负载 均衡 的 能 


14.1.1 FastDFS 概述 


FastDFS 是 
看 作 是 基于 文件 


FastDFS 有 两 个 习 
E Tracker: I 


EE 要 角 1 


F 系 统 ， 它 的 主要 功能 包括 : SCH 
。 特 别 适合 以 文件 为 载体 的 在 线 服务 。 


] C 语言 实现 的 ， 目 前 提供 了 C, Java, PHP 语言 的 支持 。 男 外 ，FastDFS 可 
的 key-value 存储 系统 ， 也 可 称 为 分 布 式 文件 存储 服务 。 

色 : 跟踪 器 (Tracker) 和 存储 节点 (Storage)。 

R 踪 服务 器 ， 是 FastDFS 的 协调 者 ， 起 负载 均衡 的 作 


储 组 〈group92) 和 存储 服务 器 (Storage Server) 的 状态 信息 


交互 的 纽带 。 
E Storage: 存储 服务 器 ， 文 件 和 文件 属 愧 
个 目录 下 的 文人 


到 对 应 的 某 个 子 
FastDFS 特别 适合 作为 
针对 文件 的 上 传 、 下 载 、 删 除 、 设 置 文件 属 


目录 下 ， 然 后 将 文人 


14.1.2 FastDFS 上 传 和 下 载 过 程 


FastDFS 提供 了 基本 文 从 
端的 方式 提供 给 了 
(1) FastDFS 上 传 过 程 : 
1) 存储 服务 器 会 定 上 
2) FastDFS 客户 端 
3) 跟踪 服务 器 


址 和 端口 。 


(clie 


十 向 跟踪 服务 器 (Tracker Server) 上 传 自 
nt) 提交 上 传 请 求 到 Tracker。 


民 据 请 求 查询 可 月 


4) 客户 端 直接 相 


Bs 


E (metadata) 者 
F 数 过 多 ， 存 储 节 点 〈Storage) 在 第 一 次 启动 时 ， 会 在 每 个 数据 存储 目 
里 创建 两 级 子 目 录 ， 每 级 有 256 个 ， 总 共 65536 MH 


上 的 存储 服务 器 ， 


等 相关 功能 。 


访问 接口 ， 例 如 upload. download. append. delete 等 ， 以 客户 
于 发 者 使 用 。 下 面 介 绍 FastDFS 上 传 和 下 载 交 互 过 程 。 


民 好 地 支持 了 这 些 需 求 ， 本 章 使 用 FastDFS 


。 记 录 集 群 中 所 有 存 
， 征 客户 端 和 数据 服务 器 


保存 到 存 


F 夹 ， 文 件 会 以 hash 的 方式 被 路 由 
数据 直接 作为 一 个 本 地 文件 存储 到 该 目录 中 。 
小 文件 (4KB < 文件 大 小 <500MB) 载体 的 在 线 服 务 。 其 提供 了 


身 状态 信息 。 


© group 组 也 可 称 为 卷 。 同 一 组 内 服务 器 上 的 文件 是 完全 相同 的 ， 同 一 组 内 的 存储 服务 器 是 对 等 的 ， 文 件 上 传 、 下 载 、 删 除 


等 操作 可 在 任意 一 台 存 储 服 务 器 上 进行 。 
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加 的 存储 服务 器 相关 信息 ， 连 接 存 储 服 务 器 进行 上 传 操 作 。 


并 返回 给 客户 端 对 应 的 存储 服务 器 的 地 


#14 FastDFS 


dn 


5) 存储 服务 器 根据 客户 端 传递 过 来 的 信息 生成 文件 名 (file id) 并 将 内 容 写 入 磁盘 ， 
入 成 功 后 ， 返 回 给 客户 端 文件 路 径 相 关 信 息 。 

6) 客户 端 收 到 存储 服务 器 返回 的 信息 后 ， 来 存储 对 应 的 文件 信息 。 

(2) FastDFS 下 载 过 程 : 

1) 客户 端 向 跟踪 服务 器 发 起 文件 下 载 请 求 。 

2) 跟踪 服务 器 根据 客户 端 传递 的 参数 分 配 可 用 的 存储 服务 器 ， 并 返 
端口 。 

3) 客户 端 根据 返回 的 文件 名 到 存储 服务 器 上 查找 文件 。 

4) 存储 服务 器 根据 客户 端 传递 过 来 的 参数 ， 返 回 给 客户 端 对 应 文件 内 容 。 


五 


存储 服务 器 地 址 和 


14.2 Spring Boot 集成 FastDFS 


创建 一 个 Spring Boot 工程 ， 工 程 名 使 用 FastDFSExample， 有 具体 创建 工程 方法 可 参照 第 7 
章 。 下 面 使 用 Spring Boot 工程 整合 FastDFS 进行 文件 相关 操作 。 

C1) 添加 依赖 

为 了 整合 FastDFS， 需 要 添加 fastdfs-client-java 依赖 ， 后 面 的 章节 需要 使 用 页 面 进行 演 
示 ， 所 以 添加 spring-boot-starter-thymeleaf 起 步 依 赖 。 具 体 如 下 : 


<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactld>spring-boot-starter-thymeleaf</artifactld> 

</dependency> 

<dependency> 
<groupId>org.csource</groupId> 
<artifactIld>fastdfs—client-java</artifactld> 
<version>1.25</version> 


</dependency> 


(2) 修改 配置 文件 
在 resources 文件 夹 下 面 创 建 一 个 名 为 fdfs_client.conf 的 配置 文件 。 其 包含 连接 Tracker 服 
务 器 超时 时 间 、socket 连接 超时 时 间 、Tracker 服务 器 地 址 和 端口 、 是 否 开启 防盗 链 功 能 等 ， 
具体 配置 如 F: 


connect timeout = 30 


network timeout = 30 

charset = UTF-8 

http.tracker_http_port = 8080 

# token 防盗 链 功能 ;，no 为 关闭 此 功能 
phate teas =no 

tracker_server = 47.95.113.117:22122 


上 面 的 配置 文件 中 ，http.anti_steal token 表示 是 否 开启 防盗 链 功 能 ， 这 里 暂时 不 使 用 ， 如 
果 有 多 台 跟 踪 服 务 器 ， 可 以 在 配置 文件 中 添加 多 个 tracker_server 键 值 对 。 
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(3) 上 传 工 具 类 


FastDFS 的 上 传 与 下 载 等 功能 ， 主 要 通过 TrackerClient 工具 类 实 


ClientUtils， 初 始 化 FastDFS 相关 工具 类 ， 具 体 如 下 : 


使 


public class FastDFSClientUtils { 


现 。 创 建 一 


private static Logger logger = LoggerFactory.getLogger(FastDF SClientUtils.class); 


/** 配置 文件 信息 */ 


private static final String confFileName="fdfs_client.conf"; 


private static TrackerClient trackerClient =null; 
static { 


try { 


个 类 FastDFS 


String filePath = new ClassPathResource(confFileName).getFile().getA bsolutePath(); 


ClientGlobal.init(filePath); 
trackerClient = new TrackerClient(); 
} catch (Exception e) { 
e.printStackTrace(); 
logger.error("FastDFS Client 初始 化 失败 ", e); 


private static TrackerServer getTrackerServer() throws IOException { 
TrackerServer trackerServer = trackerClient.getConnection(); 


return trackerServer; 


private static StorageClient getTrackerClient() throws IOException { 


TrackerServer trackerServer = getTrackerServer(); 


StorageClient storageClient = new StorageClient(trackerServer, null); 


return storageClient; 


public static String getTrackerUrl() throws IOException { 


return "http://" + getTrackerServer().getInetSocketA ddress().getHostString() 


j 


+ ":" + ClientGlobal.getG_tracker_http_port() + "/"; 


用 以 上 代码 ， 类 FastDFSClientUtils 实现 了 初始 化 FastDFS 工具 类 
文件 上 传 和 下 载 来 演示 FastDFS 的 使 用 。 


14.2.1 文件 上 传 


节 通 过 页 面 上 传 一 个 文件 ， 来 演示 FastDFS 如 何 保存 文 伯 


da>) 上 传 页 面 
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新 建 一 个 上 传 页 面 uploadfile.html， 用 来 与 用 户 进行 交互 ， 


<!DOCTYPE html> 
<html xmlns:th="http://www.thymeleaf.org"> 
<body> 


LUN F: 


#14 FastDFS 


<h2>Spring Boot FastDFS 文件 上 传 </h2> 

<form method="POST" action="/uploadAction" enctype="multipart/form—data"> 
<input type="file" name="file" /><br/> 
<input type="submit" value=" 上 传 文件 " /> 

</form> 

</body> 

</html> 


新 建 一 个 Controller 类 FastdfsController， 通 过 index 方法 定位 到 uploadfile.html WM, J 
体 如 下 : 
@Controller 
public class FastdfsController { 
private static final Logger logger = LoggerFactory.getLogger(FastdfsController.class); 
@GetMapping("/uploadpage") 
public String index() { 
return "uploadfile"; 


Au 


} 
} 


启动 服务 后 ， 访 问 路 径 http://localhost:18095/uploadpage， 就 能 直接 跳 转 到 上 传 页 面 ， 如 
14-1 所 示 。 


€ > CŒ © localhost:180 


Spring Boot FastDFS 文件 上 传 


选择 文件 | 未 选择 任何 文件 
上 传 文件 


图 14-1 上 传 页 面 
为 了 方便 接收 前 端 传递 过 来 的 参数 ， 创 建 一 个 model 类 FileInfoModel， 具 体 如 下 : 


public class FileInfoModel { 
private String name; 
private byte[] content; 
Ge Hee 


private String extName; 


public FileInfoModel() { 

} 

public FileInfoModel(String name, byte[] content,String extName) { 
this.name = name; 
this.content = content; 
this.extName=extName; 


} 
//.. 78M get 与 set 方法 
} 
(2) 上 传 功 能 实现 
FastDFS 的 上 传 功能 主要 通过 TrackerClient 实现 ， 在 上 一 节 的 工具 类 FastDFSClientUtils 
FP 添 加 uploadFile 方法 ， 实 现 文件 的 上 传 功能 ， 具 体 如 下 : 


mi 
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public static String[] uploadFile(FileInfoModel file, Map<String,String> extMap) { 
try { 
logger.info(" 1-44: " + file.getName() + "文件 大 小 :"+ file.getContent().length); 
NameValuePair[] metaArr =null; 
/ 添加 额外 数据 
if(null != extMap) { 
metaArr = new NameValuePair[extMap.size()]; 
int index=0; 
for(String key:extMap.keySet()) { 
metaArr[index] = new NameValuePair(key, extMap.get(key)); 


} 
} 


long startTime = System.currentTimeMillis(); 
String[] uploadFileResults = null; 
StorageClient storageClient = null; 


storageClient = getTrackerClient(); 
uploadFileResults = storageClient.upload_file(file.getContent(), 
file.getExtName(), metaArr); 
logger.info(" 上 传 文件 耗 时 :" + (System.currentTimeMiillis() - startTime) + " ms"); 
if (uploadFileResults == null && storageClient != null) { 
loggererror(" 上 传 文件 失败 ， 错 误 码 :" + storageClient.getErrorCode()); 
} 
String groupName = uploadFileResults[0]; 
String remoteFileName = uploadFileResults[1]; 
logger.info(" 上 传 文件 成 功 : "+ "group _name:" + groupName +", 
remoteFileName:" +" "+ remoteFileName); 
return uploadFileResults; 
} catch (Exception e) { 
e.printStackTrace(); 


} 


return null; 


} 


uploadFile 方法 有 两 个 参数 ， 第 一 个 参数 FileInfoModel， 是 自 定义 的 model 类 ， 用 于 承接 


前 端 传递 过 来 的 数据 


Sa 


value 对 的 方式 存放 在 存储 服务 器 〈storage) 上 的 同名 文件 中 。 
接 下 来 在 FastdfsController 类 中 实现 一 个 接收 前 端 上 传 请 求 的 方法 fleUploadAction， 


如 下 : 
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@PostMapping("/uploadAction") 
public String fileUploadAction(@RequestParam("file") MultipartFile file, 
RedirectAttributes redirectAttributes) { 
try { 
if (file.isEmpty()) { 
redirectAttributes.addFlashAttribute("message", "请 选择 要 上 传 的 文件 "); 
return "redirect:uploadStatus"; 


} 


String[] arrs = saveFile(file); 
String groupName = arrs[0]; 
String remoteFileName = arrs[1]; 


/拼接 路 径 


， 第 二 个 参数 Map<String,String> 用 来 存放 扩展 属性 相关 的 数据 ， 以 key- 


具体 
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String path = FastDFSClientUtils.getTrackerUrl() + groupName + "/" + remoteFileName; 
redirectA ttributes.addFlashA ttribute("message", 
" 成功 上 传 文件 : "+ file.getOriginalFilename() + ""); 

redirectAttributes.addFlashAttribute("path", path); 
redirectA ttributes.addFlashA ttribute("groupName", groupName); 
redirectAttributes.addFlashA ttribute("remoteFileName", remoteFileName); 
String fileName = file.getOriginalFilename(); 
String ext = fileName.substring(fileName.lastIndexOf(".") + 1); 
if(ext.equalsIgnoreCase("jpg")) { 

redirectA ttributes.addFlashAttribute("ext", ext); 


j 
} catch (Exception e) { 
e.printStackTrace(); 
loggererror(" 上 传 文件 失败 11 "); 
j 


return "redirect:/uploadStatus"; 


j 

/上 传 文件 方法 

public String[] saveFile(MultipartFile multipartFile) throws IOException { 

try { 
String[] fileAbsolutePath; 
String fileName = multipartFile.getOriginalFilename(); 
String ext = fileName.substring(fileName.lastIndexOf(".") + 1); 
byte[] file_buff = multipartFile.getBytes();// 获取 文件 流 
FileInfoModel file = new FileInfoModel(fileName, file_buff, ext); 
Map<String,String> data=new HashMap<>(); 
data.put("test","javadevmap"); 
I 正 传 文件 
fileAbsolutePath = FastDFSClientUtils.uploadFile(file,data); 
if (fileAbsolutePath == null) { 
loggererror(" 上传 文 件 失败 ， 请 重新 上 传 ! "; 


} 


return fileAbsolutePath; 
} catch (Exception e) { 
logger.error("upload file Exception!", e); 


} 


return null; 


} 
在 上 面 的 代码 中 ， 通 过 用 户 传递 过 来 的 MultipartFile 类 实例 读 取 文件 流 ， 然 后 通过 
FastDFSClientUtils 工具 类 的 uploadFile 方法 进行 文件 上 传 ， 返 回 给 前 端 文件 在 FastDFS 中 的 存 
放 文 件 名 。 
为 了 观察 FastDFS 是 否 上 传 成 功 ， 新 建 页 面 uploadStatus.html。 文 件 上 传 后 页 面 重 定向 到 
uploadStatus.html， 在 重 定向 页 面 进行 相关 下 载 路 径 、 组 名 、 文 件 名 等 数据 展示 ， 其 体 如 下 : 
<!DOCTYPE html> 
<html lang="en" xmlns:th="http://www.thymeleaf.org"> 
<body> 
<h1>Spring Boot FastDFS 上 传 成 功 页 面 </h1> 
<div th:if="${message}"> 
<h2 th:text="$ {message}"/> 
</div> 


TT 
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<div th:if="$ {path}"> 
TRIZ: <M th:text="$ {path} "/> 
组 名 称 : <h2 th:text="$ {groupName}"/> 
文件 名 : <h2 th:text="$ {remoteFileName}"/> 

</div> 

<div th:if="$ {ext}"> 
<img th:src="$ {path} "/> 

</div> 

</body> 

</html> 


启动 项 目 ， 访 问 http://localhost:18095/uploadpage， 上 传 一 张 图 片 ， 效 果 如 图 14-2 所 示 。 


S © @ localhost 


Spring Boot FastDFS 上 传 成 功 页 面 


成 功 上 传 文件 : 'javadevmap-demo.jpg' 


下 载 路 径 : 
http://47.95.113.117:8080/javadevmap/M00/00/00/rBHu7VsaglmAOWPaAAAaL G6U7M4889. jpg 
组 名 称 : 

javadevmap 

文件 名 : 


M00/00/00/rBHu7VsagImAOWPaAAAaLG6U7m4889.jpg 


图 14-2 上传 成 功 页 面 
本 节 实 现 了 FastDFS 的 文件 上 传 功能 。 同 时 也 返回 给 前 端 一 个 完整 的 url 路 径 ， 可 直接 复 
制 到 浏览 器 中 查看 文件 。 


14.2.2 文件 下 载 


如 果 不 想 通 过 Web 直接 下 载 文件 ， 也 可 以 通过 接口 的 形式 进行 文件 下 载 。 上 一 节 演 示 了 
如 何 进行 文件 上 传 ， 本 节 在 上 一 节 的 基础 上 实现 FastDFS 文件 的 下 载 功能 。 

(1) 下 载 方 法 

FastDFS 的 文件 下 载 功能 ， 通 过 工具 类 StorageClient 的 download file 方法 实现 。 在 上 一 节 
的 FastDFSClientUtils > downloadFile 下 载 方法 ， 有 具体 如 下 : 


public static byte[] downloadFile(String groupName, String remoteFileName) { 
try { 
StorageClient storageClient = getTrackerClient(); 
byte[] fileByte = storageClient.download_file(groupName, remoteFileName); 
return fileByte; 
} catch (Exception e) { 
e.printStackTrace(); 
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j 


return null; 


} 


上 面 方法 中 ，StorageClient 通过 组 名 和 文件 名 就 可 以 进行 文件 下 载 操 作 。 

(2) Controller 下 载 请 求 方法 

在 上 一 节 的 FastdfsController 类 中 添加 download 方法 ， 用 来 接收 前 端 提 交 的 下 载 请 求 (组 
名 和 文件 名 )， 具 体 如 下 : 


@RequestMapping(value = "/download") 
public ResponseEntity<byte[|> download(HttpServletRequest request, @RequestParam("groupName") 
String groupName, @RequestParam("remoteFileName") String remoteFileName, Model model) throws Exception { 

/下 载 文件 路 径 
HttpHeaders headers = new HttpHeaders(); 
/下 载 显示 的 文件 名 ， 解 决 中 文 名 称 乱 码 问 题 
String filename = remoteFileName.substring(remoteFileName.lastIndexOf("/")+1); 
String downloadFileName = new String(filename.getBytes("UTF-8"), "iso-8859-1"); 
/通知 浏览 器 以 attachment (下 载 方式 ) 打开 图 片 
headers.setContentDispositionFormData("attachment", downloadFileName); 
//application/octet-stream : 一 进 制 流 数 据 ( 最 常见 的 文件 下 载 )。 
headers.setContentType(MediaType.APPLICATION OCTET STREAM); 
byte[] file buff = FastDFSClentUtils.downloadFile(groupName, remoteFileName); 
return new ResponseEntity<byte[]>(file_buff, headers, HttpStatus; CREATED); 


} 
(3) 下 载 页 面 
在 上 一 节 的 上 传 成 功 页 面 uploadStatus.html 中 ， 添 加 如 下 代码 ， 使 此 页 面 能 够 提交 文件 下 
载 请 求 ， 具 体 如 下 


<!DOCTYPE html> 
<html lang="en" xmlns:th="http://www.thymeleaf.org"> 
<body> 


7| 


<h1>Spring Boot FastDFS 上 传 成 功 页 面 </h1> 
三， 


<form method="POST" action="/download" > 
<input type="hidden" name="groupName" th:value="$ {groupName}" /><br/> 
<input type="hidden" name="remoteFileName" th:value="$ {remoteFileName}" /><br/> 
<input type="submit" value=" 下载 文 件 " /> 

</form> 

</body> 

</html> 


启动 项 目 ， 访 问 http://localhost:18095/uploadpage 链 接 ， 上 传 一 个 文件 后 ， 点 击 下 载 按钮 ， 
即 可 实现 文件 的 下 载 。 
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着 业务 数据 的 增多 ， 在 站 内 搜索 信息 可 能 是 一 个 新 的 挑战 。 如 果 直 


HEE AC 


mi 


Æ 


而 


系列 问题 。ElasticSearch AYH 


AN 


mi 


首 数据 存放 在 哪个 表 中 ， 有 


具体 的 位 置 


现 搜索 相关 的 业务 需求 。 


ElasticSearch 


[ 接 查询 数据 库 ， 前 提 


。 同 时 站 内 搜索 对 搜索 耗 时 有 较 高 的 要 求 ， 如 


1S.1 ElasticSearch 基本 介绍 


力 。 


档 类 型 ， 能 够 存储 不 同 的 字段 ， 用 于 不 同类 型 的 查询 请 求 。 
m Xk (Document): 相当 于 关系 表 的 数据 行 ， 存 储 数据 的 载 
据 的 字段 : 
@ 字段 (Field): 文档 的 一 个 键 值 对 。 
@ ii| (Term): 表示 文本 中 的 一 个 单词 。 
@ 标记 《Token): 表示 在 字段 中 出 现 的 词 ， 由 该 词 的 文本 、 
及 类 型 组 成 。 
15.1.2 分 片 与 副本 的 关系 
当 系 统 中 有 大 量 的 文档 时 ， 由 于 内 存 、 硬 盘 等 硬件 资源 的 限 站 


ElasticSearchO ft 
RRI, 
开放 源码 ， 是 当 


m 文档 类 型 


He 


作 。 每 个 节点 都 可 以 配置 其 名 称 。 
E 索引 (Index): 相当 于 数据 库 ， 用 了 

段 只 能 定义 一 个 数据 类 型 。 
(Type): 相当 于 数据 库 中 的 表 ， 用 了 


=| 


A 


Fl. AN 


集群 


RESTful web 接口 
前 流行 的 企业 级 搜索 引擎 。 


15.1.1 ElasticSearch 概述 


ElasticSearch 是 一 种 文档 型 数据 
ElasticSearch ] 
E 集群 是 一 个 或 多 个 节点 的 集合 ， 用 来 保存 应 用 的 全 部 数据 并 提供 基 
成 式 索 引 和 搜索 功能 。 每 个 集群 都 需要 有 一 个 唯一 的 名 称 。 
全 来 保存 数据 并 参与 整个 集群 的 索引 和 搜索 操 


如 下 结构 : 


的 单 台 服务 器 ， 月 


哪些 字段 ， 但 是 实际 上 大 部 分 情况 是 只 知道 要 


搜索 的 内 容 


现 正 是 为 了 解决 上 面 问题 的 。 本 草 介 颖 


。ElasticSearch 是 


: KE] 


nye 


] Java 开发 的 ， 使 


节点 会 加 入 指定 名 称 的 集群 
定义 文档 类 型 的 存储 ， 在 同一 个 索引 中 ， 同 一 个 字 


© ElasticSearch 1 
© Lucene 是 一 款 高 性 能 的 、 可 扩展 的 信息 检索 CIR) E 
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E Æ https://www.elastic.co/cn/. 


有 具 库 。 


可 优化 查询 也 是 要 面临 的 一 
如 何 使 用 ElasticSearch 实 


个 基于 Lucenee 的 搜索 服务 器 。 它 提供 了 一 个 分 布 式 多 用 户 能 力 的 全 文 


中 。 


| Apache 许可 条 款 ， 


率 ， 提 供 了 存储 服务 、 搜 索 服务 、 大 数据 准 实时 分 析 等 能 


全 部 节点 的 集 


描述 文档 中 各 个 字段 的 定义 ， 不 同 的 文 


体 ， 包 含 一 个 或 多 个 存 有 数 


mE ( 


开始 和 结束 ) 以 
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时 响应 客户 端的 请 求 ， 显 然 一 个 节点 是 不 够 用 的 。ElasticSearch 采用 了 分 片 和 副本 的 模式 ， 即 


将 数据 分 成 较 小 的 部 分 ， 称 之 为 分 片 〈shard)。 每 个 分 片 可 以 放 在 不 同 的 服务 器 


E, Bl 


此 ， 数 


据 可 在 集群 节点 中 传播 ， 当 查询 的 索引 分 布 在 多 个 分 片上 时 ，ElasticSearch 会 把 查询 发 送 给 每 


个 相关 的 分 片 ， 将 结果 合 3 
ElasticSearch 为 了 提高 查询 的 吞吐 


i=} 


EE, 


使 用 


分 片 可 以 有 零 到 多 个 
操作 的 能 力 ， 其 余 的 
时 ， 将 副本 提升 为 新 
15.1.3 ElasticSearch 主要 特性 

ElasticSearch 有 以 下 主要 特性 。 


图 安装 方便 : 没有 其 他 依赖 ， 下 载 后 安装 非常 简单 。 
E Json: 输入 /输出 格式 为 Json， 不 需要 定义 Schema， 人 快捷 方便 。 
E RESTful: 基本 所 有 操作 都 可 通过 HTTP 接 


E 分 布 式 : 节点 对 外 表现 对 等 ， 加 
E 多 租户 : 可 根据 用 途 不 同 创建 对 
m ;人 实时 : 从 开始 进行 文档 索引 到 
m 文 持 插件 机 制 (分 词 插件 、 同 步 
5 上 上面 的 特性 ，ElasticSearch 常 


副本 。ElasticSearch 可 以 有 许多 相同 的 分 片 ， 其 ， 
为 副本 分 片 (replica shard)。 在 主 分 片 琉 失 或 主 分 片 所 在 服务 器 无 法 访问 
的 主 分 片 。 每 个 分 片 的 副本 默认 为 1 个 。 


在 一 起 。 主 分 片 (primary shard) 默认 是 5 个 分 片 。 
副本 机 制 。 副 本 为 一 个 分 片 的 精确 复制 ， 每 个 


主 分 片 具备 更 改 索引 等 


进行 。 
入 节点 自动 均衡 。 
应 的 索引 ， 可 以 同时 操作 多 个 索引 。 


可 以 被 检索 只 有 轻微 延 时 。 
插件 、Hadoop 插件 、 可 视 化 插件 等 )。 


基于 -| 用 于 全 文 搜索 领域 ， 构 建 业务 的 搜索 功能 模块 ， 多 是 垂 
直 领 域 的 搜索 ， 数 据 量 级 一 般 在 干 万 级 以 上 。 


15.2 ElasticSearch 基本 用 法 


本 书 重点 不 在 ElasticSearch 环境 的 安装 ，ElasticSearch 软件 环境 采用 Docker 容器 部 署 。 


ElasticSearch5.x 和 ElasticSearch2.x 的 区 别 不 是 逢 


具体 部 署 命令 参照 第 19 章 。 本 章 使 用 的 ElasticSearch 


版 本 为 2.4.0。 


大 ， 但 是 由 于 ElasticSearchS.x 集成 了 


Lucene 6.x， 其 中 最 重要 的 特性 就 是 Dimensional Point Fields， 即 多 维 浮 点 字段 ，ElasticSearch 


里 面相 关 的 字段 如 date. numeric. ip 


和 Geospatial 都 将 大 大 提升 性 能 。 磁 盘 
空间 少 一 半 ; 索引 时 间 少 一 半 ， 查询 


性 能 提升 25%; 提供 对 IPv6 的 支持 。 
更 多 新 特性 ， 大 家 可 到 官网 上 查阅 。 
ElasticSearch 安装 完成 后 ， 可 以 
在 浏览 器 或 者 Postman 中 ， 输 入 
http://{Elastic SearchIP}:9200, 查看 
当前 ElasticSearch 信息 。 如 图 15-1 
所 示 。 
返回 的 信息 包含 当前 集群 的 名 称 
“elasticsearch”、 当 前 ElasticSearch 
的 版 本 2.4.0 以 及 Lucene 的 版 本 


5.5.2 等 。 


图 15-1 ElasticSearch 信息 
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15.2.1 索引 操作 
在 创建 索引 之 前 ， 需 要 了 解 ElasticSearch 的 RESTful API 的 调用 风格 ， 管 理 和 使 用 
ElasticSearch 服务 时 ， 常 用 HTTP 请 求 方式 见 表 15-1. 


TH 


#15-1 HTTP 请 求 方式 


HTTP 请 求 方式 含 X 
GET 请 求 获取 ElasticSearch 服务 器 中 的 对 象 
POST 请 求 更 新 ElasticSearch 服务 器 中 的 对 象 
PUT 请 求 在 ElasticSearch 服务 器 上 创建 对 象 
DELETE 请 求 | 除 ElasticSearch 服务 器 中 的 对 象 
下 面 手 动 创 建 一 个 索引 。 打 开 Postman 工具 ， 按 照 前 面 所 讲 ElasticSearch 的 Restful API 


操作 规则 ， 以 put 方式 创建 一 个 名 为 productindexS 的 索引 。 如 图 15-2 所 示 。 
执行 删除 索引 ， 以 delete 方式 执行 即 可 ， 如 图 15-3 所 示 。 


DELETE w http://39.106.208.144:9200/productindex 


"acknowledged": true 


图 15-2 创建 索引 图 15-3 ”删除 索引 
当然 Spring Data ElasticSearchs 也 提供 了 工具 类 ElasticsearchTemplate 进行 索引 的 相关 操 
作 。 例 如 使 用 createIndex0 方 法 创建 索引 和 使 用 deleteIndex(0) 方 法 删除 索引 。 
例如 创建 索引 : 


@Autowired 
private ElasticsearchTemplate esTemplate; 
@Test 
public void testIndex() { 
esTemplate.createIndex(Product.class); /创建 索引 
} 


15.2.2 索引 映射 mappings 
索引 的 mappings 定义 了 文档 的 每 个 字段 的 数据 类 型 : 声明 一 个 变量 为 String 类 型 的 字 
段 ， 此 字段 只 能 存储 String 类 型 的 数据 。 同 语言 的 数据 类 型 相 比 ，mappings 还 有 一 些 其 他 的 含 


© ElasticSearch 中 索引 的 名 称 不 能 有 大 写字 母 。 
© Spring Data 与 ElasticSearch 进行 整合 ， 让 操作 变 得 简单 。 通 过 两 者 进行 整合 ， 用 户 可 以 像 操作 关系 型 数据 库 一 样 操作 


ElasticSearch，CURD、 排 序 、 分 页 操作 统统 一 步 到 位 。 
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MX, BlastieSearch 不 仅 可 以 根据 mappings 判断 一 个 字段 中 是 什么 类 型 的 值 ， 还 可 以 根据 

mappings 来 索引 数据 以 及 判断 数据 能 否 被 搜索 到 。 
接 下 来 可 以 通过 Postman 工具 查看 刚才 创建 的 

productindex 索引 的 mappings 信息 。 如 图 15-4 所 示 。 

由 于 ElasticSearch 中 只 创建 了 一 个 

productindex 索引 ， 所 以 mappings 的 内 容 为 空 。 接 

下 来 为 productindex 索引 增加 一 个 product 类 型 ， ea 


PRA 


oO 


product 类 型 productName、price、brand、 
createTime 四 个 字段 。mappings 定义 字段 用 
properties 关键 词 ， 里 面 的 type 有 以 下 几 种 类 型 ， 图 15-4 获取 mappings 信息 
见 表 15-2. 


表 15-2 mappings 中 的 数据 类 型 


类 型 E X 
string 文本 字符 类 型 
数值 类 型 Byte\short\integer\long\float\double 
date 期 类 型 
Boolean 布尔 类 型 
ip IP 类 型 ， 以 数字 形式 简化 IPv4 地 址 


例如 ， 请 求 url 为 http://39.106.208.144:9200/productindex/product/ mapping?pretty 了 >， 以 post 
方式 请 求 ， 请 求 体 为 Json， 具 体内 容 如 下 ， 效 果 如 图 15-5 所 示 。 


{ 
"product": { 
"properties": { 
"productName": { 
"type": "string" 
b 
"price": { 
"type": "double" 
} 
"brand": { 
"type": "string" 
Je 
"createDate": { 
"type": "date" 
} 
} 
} 
} 


mappings 支持 再 次 添加 字段 操作 ， 按 照 上 面 的 格式 ， 在 请 求 体 中 添加 要 增加 的 字段 以 及 
类 型 即 可 ， 但 是 不 支持 修改 已 增加 索引 的 字段 类 型 。 例 如 修改 price 类 型 由 double 类 型 变 成 


O 在 任意 的 查询 字符 串 中 增加 pretty 参数 ， 会 让 Elasticsearch 美化 输出 (pretty-print〉Json 响应 ， 便 于 阅读 。 
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String 类 型 ， 发 送 请 求 如 图 15-6 所 示 。 


POST v http://39.106.208.144:9200/productindex/product/_mapping?pretty 


Authorization Headers (1) Body Pre-request script 


POST v http://39.106.208.144:9200/productindex/product/_mapping?pretty 


Authorization Headers (1) Body Pre-request script 


form-data x-www-form-urlencoded @ raw binary 


ar 


"product": { 
"propertie: 


"acknowledged": true 


图 15-5 创建 product 类 型 图 15-6 ”修改 字段 类 型 
返回 结果 如 下 : 

{ 

"error": { 


"root_cause": [ 


"type": "illegal argument _exception", 
"reason": "mapper [price] of different type, current_type [double], merged_type [string]" 
} 
I 
"type": "illegal _argument_exception", 
"reason": "mapper [price] of different type, current_type [double], merged_type [string]" 

Je 
"status": 400 


ex 


AIL AGAR AY DA EB ENS RB BRI 


15.2.3 ElasticSearch 之 Head 插件 


状态 以 及 数据 。 


在 学 习 ElasticSearch 的 过 程 中 ， 需 要 通过 一 些 工具 如 Head 插件 查看 ElasticSearch 的 运 


ElasticSearch-Head 是 一 个 图 形 化 的 集群 操作 和 管理 工具 ， 可 以 对 集群 进行 傻瓜 式 操 


可 以 通过 插件 形式 把 它 集成 到 ElasticSearch， 也 可 以 安装 成 一 个 独立 应 用 。 


Head 插件 可 参考 第 19 章 自行 安装 ， 这 里 就 不 再 殉 述 。 安 装 完 成 后 打开 浏览 器 ， 输 入 ; 


安装 的 了 他 地址 ， 例 如 : http://{ip}:9200/_plugin/head/， 界 面 如 图 15-7 所 示 。 


群 的 基本 信息 ， 例 如 节点 情况 、 索 引 情况 等 。 
主 分 片 与 副本 的 区 别 是 粗细 边框 〈 主 分 片 是 粗 边 框 )， 如 图 15-9 所 示 。 
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在 地 址 栏 输入 ElasticSearch 服务 器 的 IP 地 址 和 端口 ， 点 击 连 接 按钮 (connect) 就 可 以 连 
接 到 ElasticSearch 集群 。 连 接 后 的 视图 如 图 15-8 所 示 。 在 界面 中 ， 可 以 看 到 ElasticSearch 集 


E C © 不 安全 | 39.106.208.144:9200/_plugin/head, 


Elasticsearch 
概览 | 索引 | 数据 浏览 基本 查询 [+] | 复合 查询 [+] 


| View | Index Filter 


http://localhost:9200/ 


CZA 


集群 概览 


图 15-7 


E CŒ |© 39.106.208.144:9200/_plugin/head/ 
连接 elasticsearch ”集群 健康 值 : yellow (5 of 10) 


概览 | 索引 | 数据 浏览 基本 查询 [+] 复合 查询 [+] 


http://39.106.208.144:9200/ 


Elasticsearch 


第 15 章 ”ElasticSearch 


Head 1 ff 


* 


Ca 


集群 概览 


size: 130B (1308) 
docs: 0 (0) 


信息 ~ ED 


| ee ~ f Sort indices ~ | View aliases = 


productindex 


Index Filter 


OF 


A Unassigned 


DBIB 


RI'nnd 
* CGD ECD 


omaa 


K| 15-8 Head 页 


fii #4 ElasticSearch fF ) 


eal 


每 个 索引 下 面 有 信息 Cnfo) 和 动作 (action) 两 个 按钮 。 
mapping 的 定义 。 动 作 可 对 索引 进行 新 建 别名 、 刷 新 、Flush 刷 


如 图 15-10 所 示 。 


析 器 、 关 闭 、 删 除 操作 。 


回国 四 回回 


oHe Ba 


图 15-9 分 片 信息 
在 Head 的 索引 页 签 中 可 以 新 建 索 引 、 
所 示 。 


D 39.106.208.144 


Elasticsearch 


基本 查询 [+] 


http://39.106.208.144:9200/ 


概览 索引 ”数据 浏览 


索引 概览 


复合 查询 [+] 


Docs 


Size 
productindex 6508/65080 


15-12 所 示 。 


作 ， 如 图 15-13 所 示 。 


图 15- 


信息 可 以 查看 索引 的 状态 和 
新 、 优 化 、 网 关 快 照 、 测 试 分 


productindex productindex 
Size: 795B (795B) Size: 795B (795B) 


docs: 0 (0) docs: 0 (0) 


Ejona wae 
回回 回回 团 回 


图 15-10 索引 菜单 
查看 索引 大 小 以 及 查看 文档 数量 等 ， 


图 15-11 


连接 elasticsearch ”集群 健康 值 ; yellow (5 of 10) 


11 索引 操作 
可 以 针对 选 定 的 索引 进行 查询 数据 相关 操作 ， 如 


在 Head 的 数据 浏览 (Browser) W24 


在 Head 的 基本 查询 (Structured Query) 页 签 中 可 以 针对 选 定 的 索引 进行 基本 查询 操 


Head 的 复合 查询 (Any Request) 页 签 类 似 一 个 Restful 客户 端 ， 可 以 对 ElasticSearch 执行 
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相关 操作 ， 如 图 15-14 所 示 。 


39.106.208.144 


Elasticsearch http://39.106.208.144:9200/ 连接 elasticsearch ”集群 健康 值 : yellow (5 of 10) 


概览 ”索引 ”数据 浏览 ”基本 查询 [+] ”复合 查询 [+] 
4 ”查询 5 个 分 片 中 用 的 5 个 . 0 命中 . HH 0.001 秒 
_index _type _id _score A 


productindex 


bP createDate 
> price 
p productName 


图 15-12 ”数据 浏览 


39.106.208.144 
Elasticsearch http://39.106.208.144:9200/ 连接 ”elasticsearch ”集群 健康 值 : yellow (5 of 10) 
索引 BENA 基本 
ctindex (0 个 文档 ) $ 
$match_all 


A 返回 格式 :Table + 显示 数量 : 1 


图 15-13 ”数据 查询 


39.106.208.144 
h http://39.106.208.144:9200, 连接 ”elasticsearch ”集群 健康 值 : yellow (5 of 10) 


2 ”基本 查询 [+ 


图 15-14 复合 查询 
Head 插件 使 用 起 来 非常 简单 ， 使 用 此 工具 基本 可 以 完成 对 ElasticSearch 所 支持 的 增删 改 
查 等 相关 操作 。 此 工具 的 具体 使 用 这 里 就 不 再 演示 ， 大 家 只 要 熟悉 使 用 方法 即 可 。 


15.2.4 ElasticSearch 中 文 插件 集成 
ElasticSearch 内 置 的 分 词 器 3 对 中 文 的 支持 并 不 友好 ， 它 把 中 文 拆 分 为 单个 字 来 进行 全 文 


O 分 词 器 : 接受 一 个 字符 串 作 为 输入 ， 将 这 个 字符 串 拆 分 成 独立 的 词 或 语汇 单元 〈token)〈 可 能 会 丢弃 一 些 标点 符号 等 字 


符 )， 然 后 输出 一 个 语汇 单元 流 (token stream). 
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ElasticSearch 


检索 ， 这 就 常常 造成 指定 的 文档 没有 被 搜索 3 


分 情况 归 因 


为 了 解决 此 问题 ， 
_analyze 和 _explain 这 两 个 专 
E explain 用 来 帮 


E analyze 可 以 


(tokenizer ) 。 


例如 使 用 _analyze 分 析 文 本 “java 程序 员 ” 使 用 


15-15 所 示 。 


Bl], | 


的 REST API. 


助 分 析 文 档 的 相关 性 评分 。 
帮助 分 析 每 一 个 字段 (field) 或 者 某 个 分 析 器 〈analyzer ) /分 词 器 


文 搜 索 不 能 满足 实际 业务 
于 分 词 器 和 映射 mappings 的 定义 存在 问题 。 
可 以 先 对 ElasticSearch 分 析 过 程 进 行 调 试 。ElasticSearch 提供 了 


需求 的 情况 。 大 部 


Postman L 


进行 演示 。 分 析 效 果 如 


http://39.106.208.144:9200/_analyze?pretty&analyzer=standard&text="java 程序 员 " 


ElasticSearch 中 的 默认 分 词 器 将 


GET v 


St 


Raw Preview 


"tokens": [ 


“java”, “程序 员 ” 两 个 词 。 


(1) IK-Analysis 分 词 器 
这 里 介绍 一 球 比 较 常 月 
文 分 词 插件 。 出 
好 的 IK 分 词 器 ， 


的 ! 


"token": 


"token": " 程 


"token": "A", 
"start_offset": 7, 
"end_offset": 8, 

"type": "<IDEOGRAPHIC>", 
"position": 3 


"java", 


"“start_offset": 1, 
"“end_offset": 5, 
"type": "<ALPHANUM>", 
"position": @ 


"Start_offset": St 
"end_offset": 6, 

"type": "<IDEOGRAPHIC>", 
"position": 1 


"token": "FR", 
"start_offset": 6, 
"“end_offset": 
"type": 
"position": 


7, 
"<IDEOGRAPHIC>" , 


15-15 


上 插件 的 安装 方法 可 以 参考 第 19 HE 
再 次 针对 “java FEF a” HEAT BT, IK 有 两 个 分 


ik max word®, iX4 


http://39.106.208.144:9200/_analyze?pretty&analyzer=standard&text="java 程 序 员 " 


atus 2000K Time 12ms 


默认 分 词 结果 


“java 程序 员 ” 拆 分 成 了 四 个 字 ， 而 实际 希望 它 能 


ITER, RENE 


RISIN 


的 中 文 分 词 器 下 -Analysis9?， 它 是 针对 ElasticSearch 的 分 词 器 扩充 


其 用 法 。 使 用 安装 


演示 使 用 这 smart。 分 析 结 果 如 图 15-16 所 示 。 


© IK-Analysis 的 网 
© ik_smart 会 做 最 粗 


上 是 https://github.com/medcl/elasticsearch—analysis—ik. 
粒度 的 拆 分 ， 例 如 会 将 “java 程序 员 ” 拆 分 为 “java, 程 序 员 ”。 


fee: ik_smart© All 


© ik max word 会 将 文本 做 最 细 粒 度 的 拆 分 ， 例 如 会 将 “java 程序 员 ” 拆 分 为 “java, 程 序 员 ,程序 , 序 , 员 ”， 会 穷尽 各 种 可 能 的 


组 合 。 
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=] 


http://39.106.208.144:9200/_analyze?pretty&analyzer=ik_smart&text="java 程序 员 " 


图 15-16 IK 分 词 器 结果 
通过 输出 的 效果 ， 可 以 看 到 使 用 下 分 词 器 后 ， 将 短语 拆 分 成 需要 的 格式 。 
(2) 自 定 义 扩展 词 
很 多 行业 都 有 一 些 特定 的 专业 术语 ， 网 络 上 也 有 许多 流行 语 ， 默 认 的 IK 分 词 器 显然 没 法 
全 面 覆盖 它们 ， 需 要 在 IK 分 词 器 插件 中 扩展 配置 自己 的 词语 。 
例如 “了 丑 橘 ”这 个 词 ， 使 用 默认 IK opr “HA”, 效果 如 图 15-17 所 示 。 
http://39.106.208.144:9200/_analyze?pretty&analyzer=ik_smart&text= " HAM" 


GET v http://39.106.208.144:9200/_analyze?pretty&analyzer=ik_smart&text=" H i" 


Authorization Headers (0) Pre-request script 


No Auth 


Status 2000K Time 27ms 


w Preview 


"tokens": [ 


"token": "H", 
"start_offset": 1, 
"end_offset": 2, 
"type": "CN_WORD", 
"position": @ 


"token": "$", 
"start_offset": 2, 
"end_offset": 3, 
"type": "CN_WORD", 
"position": 1 


图 15-17 不 支持 的 分 词 


324 


BE 


显然 下 的 词典 里 面 没有 “了 丑 橘 ” 这 个 词 ， 所 以 它 被 拆 分 成 单个 字 。 通 过 查看 IK 
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的 配置 


文件 {安装 路 径 }/elasticsearch/config/analysis-ik/IKAnalyzer.cfg.xml， 找 到 自 定义 词语 的 配置 文 


牛 。IKAnalyzer.cfg.xml 有 具体 内 容 如 下 : 


<?xml version="1.0" encoding="UTF-8"?> 
<!DOCTYPE properties SYSTEM "http://java.sun.com/dtd/properties.dtd"> 
<properties> 
<comment>IK Analyzer 扩展 配置 </comment> 
<! 一 用 户 可 以 在 这 里 配置 自己 的 扩展 字典 一 > 
<entry key="ext dict">custom/mydict.dic;custom/single word low freq.dic</entry> 
<! 一 用 户 可 以 在 这 里 配置 自己 的 扩展 停止 词 字 上 典 一 > 
<entry key="ext_stopwords">custom/ext_stopword.dic</entry> 
<! 一 用 户 可 以 在 这 里 配置 远程 扩展 字典 一 > 
<!—- <entry key="remote_ext_dict'">words_location</entry> ——> 
<! 一 用 户 可 以 在 这 里 配置 远程 扩展 停止 词 字典 --> 
<!— <entry key="remote ext stopwords">words location</entry> —> 
</properties> 


根据 文件 内 的 提示 ， 需 要 在 custom/mydict.dic 文件 里 面 增加 自 定 义 词汇 ， 将 “ 丑 权 ” 添 加 


mm 


使 用 IK ay ir “A”, 效果 如 图 15-18 所 示 。 


GET v http://39.106.208.144:9200/_analyze?pretty&analyzer=ik_smart&text="H#%" 


Authorization Headers (0) Pre-request script Tests 


No Auth ne 


"tokens": [ 


"token": "Him", 
"“start_offset": 1, 
“end_offset": 3, 
"type": "CN_WORD", 
"position": @ 


图 15-18 Ae SORA ap el ER 
由 输出 结果 可 见 IK piel as ADEA “AAR” Mie]. 


15.2.5 ElasticSearch 中 文 检索 示例 


本 市 简单 演示 如 何 使 用 下 分 词 器 实现 检索 功能 。 希 望 把 检索 到 的 关键 词 用 红色 字体 显示 


出 来 (<font color='red'>XXX</font>)， 来 凸显 关键 词 功能 。 


进来 。 打 开 mydict.dic XAF, W “HAR” WE, Ta E F ElasticSearch 服务 。 


再 次 


创建 一 个 名 为 javadevmap-news 的 索引 ， 设 置 它 的 分 析 器 用 IK, MEH ik_smart 分 词 器 ， 


并 创建 名 为 news 的 类 型 ， 它 只 有 一 个 message 字段 ， 并 指明 使 用 ik smart 分 词 器 。 这 里 虹 


以 put 方式 请 求 操作 。 创 建 索 引 和 类 型 的 步骤 如 下 。 
求 路 径 为 : 


http://39.106.208.144:9200/javadevmap-news 


a 


E fig ee 
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提交 内 容 为 
{ 


"settings" : { 
"analysis" : { 
"analyzer" : { 
"ik" : { 
"tokenizer" : "ik_smart" 


}, 
"mappings" : { 
"news" : { 
"dynamic" : true, 
"properties" : { 
"message": { 
"type" : "string", 
"analyzer" : "ik smart" 


} 
使 用 Postman 工具 进行 提交 ， 如 图 15-19 所 示 。 


PUT v http://39.106.208.144:9200/javadevmap-news 


Authorization Headers (1) Body Pre-request script 


form-data x-www-form-urlencoded @ raw binary 


x 


"settings" : 


{ 
if 
"ik" : { 
"tokenizer" : "ik_smart" 
} 


} 
} 


"mappings" : { 
"news" : { 
“dynamic” : true, 
"properties" : { 
"message" : { 
"type" : "string", 
"analyzer" : "ik_smart" 
} 
} 


Status 2000K Time 57ms 


图 15-19 ”创建 索引 
执行 完 上 面 的 操作 后 ， 使 用 post 方式 向 索引 添加 一 些 数据 ， 方 便 接 下 来 的 查询 。 
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请 求 路 径 为 : http://39.106.208.144:9200/javadevmap-news/news/1 
提交 内 容 为 ，{"message" : "航拍 西班牙 田野 艳丽 美景 色彩 柔美 如 缴 带 " } 
请 求 路 径 为: http://39.106.208.144:9200/javadevmap-news/news/2 
提交 内 容 为 : fmessage" : "无 人 机 航拍 :“ 天 空 之 眼 ”"} 
使 用 Postman 进行 搜索 演示 ， 搜 索 “ 无 人 机 ” 以 post 方法 提交 Json 数据 请 求 。 具 体 如 下 : 
请 求 路 径 为 : http://39.106.208.144:9200/javadevmap-news/news/_search?pretty 
提交 内 容 为 : 


{ 
"query" : { "match" : { "message" : "无 人 机 " }}, 
"highlight" : { 
"pre tags" : ["<font color='red'>"], 
"post_tags" : ["</font>"], 
"fields" : { 
"message": {} 
} 
} 
} 
搜索 结果 如 下 : 
{ 
"took": 4, 
"timed out": false, 
" shards": { 
"total": 5, 
"successful": 5, 
"failed": 0 
Jo 
"hits": { 
"total": 1, 
"max _ score": 0.13424811, 
"hits": [ 
{ 
" index": "javadevmap-news", 
" type": "news", 
ai dau 
"score": 0.13424811, 
" source": 
"message": "无 人 机 航拍 :“ 天 空 之 眼 ”" 
"highlight": { 
"message": [ 
"<font color='red> 无 人 机 </font> 航 拍 :“ 天 空 之 眼 ”" 
] 
} 
} 
] 
} 


返回 字段 的 含义 见 表 15-3. 
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表 15-3 ”返回 字段 含义 


took ElasticSearch 查询 花费 的 时 间 ， 单 位 为 毫秒 
time_out 标识 ElasticSearch 查询 是 否 超时 
_shards 描述 ElasticSearch 查询 分 片 的 信息 ， 如 共 查 询 了 多 少 个 分 片 、 成 功 的 分 片 数 量 、 失 败 的 分 片 数 量 等 
hits ElasticSearch 搜索 的 结果 ，total 是 全 部 的 满足 的 文档 数目 ，hits 是 返回 的 实际 数 
_score 文档 的 分 数 信息 ， 跟 排名 相关 度 有 关 
highlight 高 亮 ， 针 对 检索 结果 中 的 关键 词 进行 高 亮 显示 
从 上 面 的 结果 可 见 ， 可 以 通过 ElasticSearch 实现 搜索 能 力 ， 并 且 对 关键 词 进行 高 亮 显 示 。 


15.3 SpringBoot 集成 ElasticSearch 


本 节 以 商品 搜索 功能 为 例 讲解 ElasticSearch， 通 过 ElasticSearch 创建 一 个 Product 的 索 
引 ， 并 进行 增删 改 查 相关 操作 。 演 示 的 程序 并 不 是 使 用 ElasticSearch 的 Java 客户 端 直接 访问 
ElasticSearch 服务 器 ， 而 是 通过 Spring Data 的 ElasticSearch 组 件 与 ElasticSearch 服务 交互 。 
Spring Data ElasticSearch 已 经 提供 了 对 于 索引 中 类 型 〈type) 基本 操作 的 文 持 。 

创建 一 个 Spring Boot 工程 ， 工 程 名 为 ElasticSearchExample， 使 用 Spring Boot 工程 整合 
ElasticSearch 进行 数据 操作 。 


15.3.1 整合 ElasticSearch 


C1) 添加 依赖 
整合 ElasticSearch， 需 要 添加 起 步 依赖 spring-boot-starter-data-elasticsearch。 上 有 具体 如 下 : 


<dependency> 
<grouplId>org.springframework.boot</groupId> 
<artifactld>spring—boot-starter-data-elasticsearch</artifactld> 
</dependency> 


(2) 修改 配置 文件 
在 配置 文件 application.yml 中 添加 相关 配置 ， 这 里 需要 填写 计算 机 名 称 ， 以 及 集群 节点 的 
IP 和 端口 ， 其 体 配 置 如 下 : 


server: 
port: 18093 
spring: 
application: 
name: elasticsearch-example 
data: 
elasticsearch: 
cluster-name: elasticsearch 
cluster-nodes: 39.106.208.144:9300 
repositories: 
enabled: true 


只 要 以 上 两 步 ， 即 可 完成 ElasticSearch 与 Spring Boot 的 工程 整合 。 
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15.3.2. ElasticSearch 操作 数据 


可 以 通过 实体 类 来 进行 类 型 的 mapping 映射 。 首 先 定义 商品 的 数据 结构 ， 创 建 包 
com.javadevmap.elasticexample.model， 然 后 新 建 Product 类 ， 具 体 如 下 : 


@Document(indexName = "java~dev-map", type = "product") 
public class Product { 
@Id 
private String id; 
private String productName; 
private Integer price; 
private String brand; 
private String productDesc; 
@Field(type = FieldType.String, index = FieldIndex.not_analyzed) 
private String productPic; 


public Product() { 
} 


public Product(String id, String productName, Integer price, String brand) { 
this.id = id; 
this.productName = productName; 
this.price = price; 
this.brand = brand; 
j 
/... 省 略 get 与 set 方法 


@Override 
public String toString() { 
return "Product {" + 

"id=" + id +'\" + 
", productName="" + productName + '\" + 
", price=" + price + 
", brand=" + brand + '\" + 
", productDesc=" + productDesc + '\" + 
", productPic=" + productPic + '\" + 


is 
} 
在 Product 类 上 使 用 Spring Data Elasticsearch 的 注解 @Document(indexName = "java-dev- 


map", type = "productD)， 此 注解 声明 Product 类 为 被 索引 的 文档 ， 属 性 indexName 声明 了 索 
引 的 名 称 ， 属 性 type 声明 了 索引 中 文档 的 类 型 。 字 段 id 上 的 注解 @Id 即 文档 的 主键 ， 是 唯一 
ERIR o Product 类 中 字段 productPic 的 注解 @Field(type = FieldType.String, index = 
FieldIndex.not_analyzed)， 声 明了 字段 productPic 的 数据 类 型 为 String， 同 时 该 字段 的 值 不 做 分 
析 ， 不 做 分 析 的 字段 在 搜索 时 是 会 进行 完全 匹配 的 。 字 段 productName price. brand, 
productDesc 没有 添加 @Eield 注解 ，ElasticSearch 会 根据 其 Java 类 型 自动 确定 数据 类 型 ， 同 
时 对 字段 的 值 进行 文本 分 析 ， 因 此 可 以 支持 全 文 检索 。 
ElasticSearch 常用 于 实体 Bean 的 注解 见 表 15-4. 


i 
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表 15-4 Bean 注解 


注解 x 5 
@Document 文档 对 象 索引 信息 、 文 档 类 型 ) 

@ld 文档 主键 ， 是 唯一 标识 

@Field 每 个 文档 的 字段 配置 (类 型 、 是 否 分 词 、 是 否 存 储 、 分 间 器 ) 


在 定义 完 Product 实体 Bean 后 ， 创 建 相应 的 仓库 与 ElasticSearch 进行 交互 。Spring Data 
为 开发 者 简化 了 与 数据 源 的 操作 交互 方式 。 只 需 按 照 接 口 的 方式 声明 所 要 执行 的 操作 即 可 ， 
体 的 实现 由 Spring Data 自动 生成 。Spring Data 提供 了 对 常见 的 创建 、 查 询 、 更 新 和 删除 操作 
以 及 分 页 和 排序 的 支持 ， 显 著 降 低 了 开发 人 员 操 作 ElasticSearch 的 门槛 。 


public interface ProductRepository extends ElasticsearchRepository<Product, String> { 


j 
这 里 读者 会 发 现 不 需要 实现 任何 方法 ， 当 前 ProductRepository 已 经 具备 了 基本 的 增删 改 碍 
能 力 。 编 写 一 个 测试 类 进行 验证 。 
@RunWith(SpringRunner.class) 
@SpringBootTest(classes = ElasticSearchExampleApplication.class) 
public class TestProductRepository { 


@Autowired 
ProductRepository productRepository; 


4 


@Test 

public void test() { 
Product product = new Product("1001", "JavaDevMap learn Elasticsearch", 67d, "计算 机 网 络 "); 
Product saveBean = productRepository.save(product); 
System.out.printIn("save id is :"+saveBean.getId()); 
Product findBean = productRepository. findOne(saveBean.getld()); 
System.out.println("findBean is :"+findBean); 
findBean.setBrand("update brand"); 
productRepository.save(findBean); 
Product updateBean = productRepository.findOne(findBean.getld()); 
System. out.println("updateBean is "+updateBean); 
productRepository.delete(updateBean.getId()); 
Product searchBean = productRepository. findOne(findBean. getId()); 
System.out.println("delete search result is "+searchBean); 


} 
运行 结果 如 下 : 
save id is :1001 
findBean is :Product{id='1001', productName="JavaDevMap learn Elasticsearch’, price=67.0, brand=' 计 算 
机 网 络 , productDesc="'null', productPic='null'} 
updateBean is Product{id='1001', productName='JavaDevMap learn Elasticsearch', price=67.0, 


brand="'update brand’, productDesc="'null', productPic='null'} 
delete search result is null 


当 这 些 默 认 方 法 不 能 履 盖 所 有 业务 的 数据 操作 需求 时 ， 就 需要 扩展 方法 。 扩 展 使 用 方法 
时 ， 就 好 像 用 英文 直译 要 做 的 事情 一 样 来 定义 方法 名 ， 例 如 想 通 过 brand 来 查找 ElasticSearch 
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Lae 


通过 brand 查找 的 能 力 。 下 面 在 


ProductRepository 中 定义 儿 个 方法 来 扩充 ElasticSearch 操作 的 能 


public interface ProductRepository extends ElasticsearchRepository<Product, String> { 
Page<Product> findByProductName(String productName, Pageable pageable); 
List<Product> findByBrand(String brand); 
List<Product> findByPriceLessThan(double price); 
List<Product> findByPriceGreaterThan(double price); 


作 语 名 的 建立 ， 使 用 以 


} 


就 如 上 面 所 写 ， 只 要 把 想 做 的 事 按照 JPA 的 规则 命名 一 个 方法 ， 即 完成 了 ElasticSearch 操 


的 操作 能 


上 规则 (参见 7.5.2 节 )， 就 可 以 自 


15.4 SpringBoot 集成 Java Rest Client 


组 装 接口 方法 来 扩展 ElasticSearch 


ElasticSearch 的 访问 支持 多 种 语言 ， 在 官网 上 可 以 看 ElasticSearch 使 用 标准 的 RESTful 
其 他 语言 的 客户 端 ， 例 如 Java, Python,.NET 和 PHP 等 。 


API 和 JSON， 构 建 和 维护 了 很 多 


用 方便 、 文 持 异 步 
ElasticSearch 版 本 


Java Rest Client 是 相对 于 Jav 


C1) 添加 依赖 


<dependency> 


并 且 完 全 遵守 Restful API 风格 。 


a API 更 加 轻 


量 级 的 客户 端 


有 依赖 少 、 上 自动 负载 均衡 、 使 


调用 、 Gr. Bae, 


而 且 Java Rest Client 兼容 所 有 的 


在 pom 文件 中 添加 如 下 依赖 : 


<groupId>org.elasticsearch.client</groupId> 


<artifactld>elasticsearch— 


rest—client</artifactId> 


<version>6.2.4</version> 


</dependency> 


下 面 简要 演示 其 使 用 方法 。 


添加 完 上 面 的 依赖 ， 就 可 以 在 项 目 中 使 用 Java Rest Client 工具 了 。 


(2) 初始 化 客户 端 
Java Rest Client 主要 的 工具 


据 操 作 。 代 码 如 下 : 


private static RestClient restClient; 
public static RestClient getRestClient() { 
return RestClient.builder(new HttpHost("39.106.208.144", 9200, "http")) 
.setRequestConfigCallback( 
new RestClientBuilder.RequestConfigCallback() { 


@Override 


类 为 RestClient, JLT 


类 用 


于 对 ElasticSearch 进行 相关 的 数 


public RequestConfig. Builder customizeRequestConfig( 
RequestConfig. Builder requestConfigBuilder) { 


return 


} 


requestConfigBuilder 


.setConnectTimeout(5000) 
.setSocketTimeout(60000); 


}).setMaxRetryTimeoutMillis(60000).buildQ; 
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@Before 
public void getRest() { 
restClient=getRestClient(); 


} 


注意 由 于 一 般 线 上 业务 ElasticSearch 为 集群 模式 ， 所 以 RestClient 在 创建 的 时 候 ， 可 以 传 
递 多 个 HttpHost， 这 样 RestClient 也 会 进行 相应 的 负载 均衡 。 

为 防止 业务 数据 的 泄露 ， 实 际 业 务 中 的 ElasticSearch 一 般 会 添加 Http 基本 认证 ， 那 么 就 
需要 换 一 种 连接 ElasticSearch 的 方式 ， 使 用 CredentialsProvider 的 方式 连接 ElasticSearch, HA% 
使 用 方法 如 下 : 


CredentialsProvider credentialsProvider = new BasicCredentialsProvider(); 
credentialsProvider.setCredentials(AuthScope.ANY, 
new UsernamePasswordCredentials(" 用 户 名 " "密码 ")); 
RestClient.builder(new HttpHost("39.106.208.144",9200,"http")) 
.setHttpClientConfigCallback( 
new RestClientBuilder.HttpClientConfigCallback() { 
@Override 
public HttpAsyncClientBuilder customizeHttpClient( 
HttpAsyncClientBuilder httpClientBuilder) { 
returnhttpClientBuilder.setDefaultCredentialsProvider(credentialsProvider); 
} 
}). setMaxRetry TimeoutMillis(60000).build(); 


(3) 查询 ElasticSearch 信息 


@Test 

publicvoid testEsInfo()throwsException { 
String endpoint = "/"; 
Map<String, String> params = Collections.singletonMap("pretty", "true"); 
Response response = restClient.performRequest("GET", endpoint,params); 
System.out.println(Entity Utils.toString(response.getEntity())); 


I= 


} 


使 用 如 上 方法 ， 会 输出 ElasticSearch 的 版 本 信息 等 ， 等 同 于 访问 http://{ElasticSearchIP}: 
9200. 
(4) 创建 索引 
创建 一 个 名 为 java-dev-map-rest 的 索引 ， 设 置 它 的 分 析 器 用 IK, EH 让 smart 分词 器 ; 
并 创建 名 为 news 的 类 型 ， 它 只 有 一 个 message 字段 ， 此 字段 同样 使 用 ik smart 分词 器 。 这 里 
需要 以 put 方式 提交 请 求 。 创 建 索引 和 类 型 的 方法 如 下 : 
@Test 
public void testCreateIndex() throws Exception { 
String method = "PUT"; 
String endpoint = "/java-dev-map-rest"; 
HttpEntity entity = new NStringEntity( 
W {\n" + 


\"settings\" : {\n" + 

y \"analysis\" : {\n" + 

\"analyzer\" : {\n" + 

V \"ik\" fn" + 

\"tokenizer\" : \"ik_smart\"\n" + 
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y }\n" + 
y Yin" + 
Y y\in" + 
y }\n"+ 
\"mappings\" : {\n" + 
uw \"news\" : {\n" + 
\"dynamic\" : true,\n" + 
\"properties\" : {\n" + 
\"message\" : {\n" + 
y \"type\" : \"string\",\n" + 
y \"analyzer\" : \"ik_smart\"\n" + 
y }\n" + 
y }\n" + 
y\in" + 
i y\in" + 
"}", ContentIlype.APPLICATION_JSON); 


Response response = restClient.performRequest(method,endpoint, 
Collections.<String, String>emptyMap(), entity); 
System.out.println(Entity Utils.toString(response.getEntity())); 
j 


(5) 添加 文档 数据 


@Test 
public void testCreateDocument()throws Exception{ 
Map<String, String> params = Collections.singletonMap("pretty", "true"); 
String method = "PUT"; 
String endpoint = "/java~dev-map-test/news/ 1"; 
HttpEntity entity = new NStringEntity( 
"{\"message\" :航拍 西班牙 田野 艳丽 美景 色彩 柔美 如 组 带 \ 3", 
ContentType.APPLICATION JSON); 
Response response = restClient.performRequest(method,endpoint,params, entity); 
System.out.println(Entity Utils.toString(response.getEntity())); 
endpoint = "/java-dev-map-rest/news/2"; 
entity = new NStringEntity("{\"message\" :无 人 机 航拍 :“ 天 空 之 眼 ”\" 3", 
ContentType.APPLICATION JSON); 
response = restClient.performRequest(method,endpoint, params,entity); 
System.out.println(Entity Utils.toString(response.getEntity())); 


j 


(6) 查询 数 
希望 查询 关键 词 “ 无 人 机 ”， 并 以 红色 字体 显示 出 关键 字 (<font color='red 人 > 关键 词 
</font>)， 来 凸显 关键 词 功 能 。 


@Test 
public void testGetDocsByParams() throws Exception { 
String method = "POST"; 
String endpoint = "/java~dev-map-test/news/_search?pretty"; 
HttpEntity entity = new NStringEntity(" {\n" + 
H \"query\" : { \"match\" : { \"message\" : VJE AMIN" }},\n" + 
al \"highlight\" : {\n" + 
j \"pre_tags\" : [\"<font color='red'>\"],\n" + 


RU 
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\"post_tags\" : [\"</font>\"],\n" + 
i \"fields\" : {\n" + 

y \"message\" : {}\n" + 

" y\in" + 

i Mn" + 

"}", ContentType.APPLICATION JSON); 


Response response = restClient.performRequest(method,endpoint, 
Collections.<String, String>emptyMap(), entity); 
System.out.println(Entity Utils.toString(response.getEntity())); 
} 


执行 上 面 的 程序 ， 可 见 Java Rest Client 使 用 非常 方便 。 在 实际 业务 中 ， 可 以 先 在 Postman 
等 工具 中 测试 好 ElasticSearch 网 络 请 求 ， 然 后 复制 到 NStringEntity 中 ， 就 可 以 完成 相应 的 业务 
操作 。 
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167 定时 任务 


业务 系统 常常 由 于 某 些 业务 的 需求 ， 要 在 特定 时 刻 或 者 特定 时 间 间 隔 中 做 一 些 事情 。 例 如 


研发 一 个 电 商 平台 ， 需 要 实时 查看 当前 订单 成 交 总 额 情况 ， 这 就 需要 用 定时 任务 不 停 地 查看 系 


统 内 的 订单 并 且 


统计 总 额 ; 或 者 对 于 用 户 还 未 支付 的 订单 ， 想 在 订单 有 效 期 内 提醒 用 户 ， 这 就 


需要 定时 查看 系统 内 的 未 文 付 订 自 


且 监 控 订 单 的 有 效 时间 ， 在 失效 前 提醒 用 户 支付 ， 或 者 


} 


运营 人 员 期 望 每 天 生成 一 个 统计 表 ， 用 来 展示 前 一 天 平台 内 所 有 用 户 的 购买 情况 ， 这 也 需要 用 


一 个 定时 任务 每 天 按时 启动 统计 。 以 上 这 些 应 用 场景 都 是 定时 任务 的 用 武之 地 。 


16.1 Spring Boot 定时 任务 


Spring Boot 
解 ， 此 方法 就 会 根据 注解 


工程 可 以 轻松 实现 单个 服务 的 定时 任务 ， 只 要 在 方法 上 添加 @Scheduled 注 


指定 的 定时 规则 去 执行 。 


16.1.1 单线 程 定时 任务 


根据 之 前 章节 的 ; 


解 ， 创 建 一 个 Spring Boot 工程 ， 命 名 为 ElasticJobExample， 接 下 来 几 


节 将 在 此 工程 中 分 别 演 示 @Scheduled 形式 的 定时 任务 和 ElasticJob 形式 的 分 布 式 任务 。 
a) 单个 任务 


@Component 
public class TimedTask { 
@Scheduled(cron="0/10 * * * * 2") 
public void task1() { 
System.out.printIn(Thread.currentThread().getName() + " task1: " + new Date()); 


} 
} 


运行 服务 结果 如 下 : 
pool-3-thread-1 task1: Wed May 23 14:41:40 CST 2018 


pool-3-thread-1 task1: Wed May 23 14:41:50 CST 2018 
pool-3-thread-1 task1: Wed May 23 14:42:00 CST 2018 


(2) 多 个 任务 


两 个 定时 任务 ， 


在 TimedTask %4 


在 工程 中 添加 类 TimedTask， 在 此 类 中 实现 如 下 内 容 : 


输出 可 见 ，taskl 方法 每 隔 10s 打印 一 次 线程 和 时 间 信 息 ，@Scheduled 注解 标明 此 方法 
是 一 个 定时 任务 ，cron 属性 指定 了 定时 任务 执行 的 时 间 周 期 。cron 属性 不 仅 能 够 指定 时 间 间 
be, ABST AAI TA]. cron 的 用 法 会 在 后 面 介绍 。 


FP， 还 可 以 定义 一 个 由 @Scheduled 注解 标注 的 方法 ， 这 样 在 此 类 中 就 有 


例如 在 类 ! 


添加 如 下 方法 ， 指 定 每 Ss 执行 一 次 任务 。 
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运行 


@Scheduled(cron="0/5 * * * * 2") 
public void task2() { 


System.out.println(Thread.currentThread().getName() + " task2: " + new Date()); 


} 
服务 结果 如 下 : 


pool-3-thread-1 task2: Wed May 23 14:47:55 CST 2018 
pool-3-thread-1 task2: Wed May 23 14:48:00 CST 2018 
pool-3-thread-1 task1: Wed May 23 14:48:00 CST 2018 
pool-3-thread-1 task2: Wed May 23 14:48:05 CST 2018 
pool-3-thread-1 task2: Wed May 23 14:48:10 CST 2018 
pool-3-thread-1 task1: Wed May 23 14:48:10 CST 2018 


由 输出 可 见 ，task2 每 隔 Ss 执行 一 次 任务 ，taskl 每 隔 10s 执行 一 次 任务 ， 但 是 你 会 发 现 


这 两 个 任务 使 用 的 是 同一 个 线程 ， 那 么 某 一 任务 如 果 执 行 时 间 过 长 ， 会 对 另 一 任务 造成 什么 


影响 呢 ? 
(3) 


修改 task! 方法 ， 在 方法 


务 的 影响 


运行 


单线 程 多 任务 的 相互 影响 


o 


@Scheduled(cron="0/10 * * * * ?") 
public void task1() { 


E 务 执行 耗 时 ， 观 察 对 两 个 定时 任 


添加 一 个 sleep 方法 ， 模 拟人 有 


System.out.println(Thread.currentThread().getName() + " task1: " + new Date()); 


try { 
TimeUnit.SECONDS.sleep(10); 
} catch (Exception e) { 
e.printStackTrace(); 
} 
} 


服务 结果 如 下 : 


pool-3-thread-1 task1: Wed May 23 15:01:20 CST 2018 
pool-3-thread-1 task2: Wed May 23 15:01:30 CST 2018 
pool-3-thread-1 task2: Wed May 23 15:01:35 CST 2018 
pool-3-thread-1 task1: Wed May 23 15:01:40 CST 2018 
pool-3-thread-1 task2: Wed May 23 15:01:50 CST 2018 
pool-3-thread-1 task2: Wed May 23 15:01:55 CST 2018 


由 输出 可 见 ， 此 种 情况 ， 由 于 taskl 执行 耗 时 过 长 ， 会 导致 task2 需要 等 待 taskl 执行 完 之 
后 ， 才 能 开始 计时 和 执行 任务 ， 可 见 两 个 定时 任务 在 单线 程 的 情况 下 是 相互 阻塞 的 。 
16.1.2 ”多 线程 定时 任务 

使 用 多 线程 的 方式 执行 任务 ， 可 以 避免 任务 间 的 相互 干扰 。 下 面 介 绍 使 用 注解 和 线程 池 两 
种 方式 实现 多 线程 定时 任务 。 

(1) 注解 实现 多 线程 


执行 程序 
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可 以 看 到 如 下 输出 。 


在 TimedTask 类 上 添加 注解 @EnableAsync， 在 两 个 定时 任务 的 方法 上 添加 注解 @Async。 


SimpleAsyncTaskExecutor-1 task2: Wed May 23 15:34:50 CST 2018 
SimpleAsyncTaskExecutor—2 task1: Wed May 23 15:34:50 CST 2018 


SimpleAsyncTaskExecutor-3 task2: Wed May 23 15:34:55 CST 2018 
SimpleAsyncTaskExecutor-4 task1: Wed May 23 15:35:00 CST 2018 
SimpleAsyncTaskExecutor—5 task2: Wed May 23 15:35:00 CST 2018 
SimpleAsyncTaskExecutor-6 task2: Wed May 23 15:35:05 CST 2018 
SimpleAsyncTaskExecutor—7 task2: Wed May 23 15:35:10 CST 2018 
SimpleAsyncTaskExecutor-8 task1: Wed May 23 15:35:10 CST 2018 


方法 的 
(2) 线程 池 实 现 多 线程 


由 输出 可 见 ， 此 种 方式 ， 
耗 时 完全 不 影响 任务 的 时 间 间 隔 。 


用 于 执行 定时 任务 ， 并 且 在 taskl 任务 中 ， 


总 是 会 新 创建 一 个 线程 


去 掉 在 TimedTask 28! 


添加 的 多 线程 注解 ， 在 工程 中 添加 一 个 配置 类 ScheduledConfig， 


此 类 用 来 创建 线程 池 ， 


具体 内 容 如 下 : 


@Configuration 


public class ScheduledConfig implements SchedulingConfigurer { 


@Override 


public void configureTasks(ScheduledTaskRegistrar scheduledTaskRegistrar) { 
scheduledTaskRegistrar.setScheduler(setTaskExecutors()); 


} 


@Bean 


public Executor setTaskExecutors() { 
return Executors.newScheduledThreadPool(3); 


j 
} 
运行 服务 结果 如 下 : 

pool-1-thread-1 task2: 
pool-1-thread-2 task2: 
pool-1-thread-2 task1: 
pool-1-thread-1 task2: 
pool-1-thread-2 task2: 
pool-1-thread-2 task2: 
pool-1-thread-3 task1: 
pool-1-thread-1 task2: 
pool-1-thread-1 task2: 


时 间 的 影响 。 


由 输出 可 见 ，task2 的 执行 没有 受到 taskl 耗 时 的 


Wed May 23 16:04:05 CST 2018 
Wed May 23 16:04:10 CST 2018 
Wed May 23 16:04:10 CST 2018 
Wed May 23 16:04:15 CST 2018 
Wed May 23 16:04:20 CST 2018 
Wed May 23 16:04:25 CST 2018 
Wed May 23 16:04:30 CST 2018 
Wed May 23 16:04:30 CST 2018 
Wed May 23 16:04:35 CST 2018 


i= =A 
ae 己 运 行 


W, taskl 本 身 的 计时 受到 了 自 


16.1.3 ”用 定时 任务 实时 统计 


上 面 演示 了 定时 任务 的 使 用 方法 ， 但 是 要 想 真正 理解 一 种 技术 还 需要 在 实战 中 进行 应 上 


下 面 模拟 一 种 情况 ， 让 定时 任务 实时 统计 电 商 平台 当天 的 订单 流水 。 


(1) 创建 一 个 数据 库 表 


创建 一 个 简单 的 数据 库 订 单 表 order job， 用 于 记录 一 个 电 商 平台 的 订单 信息 ， 此 表 中 每 
个 字段 的 含义 如 下 : 
E id: 订单 ID。 


E price: 订单 的 价格 。 


E userid: 此 订单 的 购买 者 。 
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m status: 订单 支付 状态 ，0 RACH, TEATS FOE fa 


字段 ， 后 面 会 使 用 此 字段 。 
E createtime: 订单 创建 时 间 。 
E statis: 订单 是 否 已 经 计 入 统计 汇总 ， 本 节 没 有 使 用 此 字段 。 


单 明 了 所 以 没有 使 


此 


ag 


创建 完 以 上 数据 库 表 后 ， 在 工程 中 添加 Mybatis、 起 步 依赖 及 工程 配置 ， 以 实现 操作 数据 


库 的 能 力 。 
(2) 添加 自 定 义 mapper 


mybatis/manual 目录 下 ， 添 加 文件 OrderManualMapperxml， 此 文 从 


<?xml version="1.0" encoding="UTF-8" ?> 


F 的 内 容 如 下 : 


由 于 要 对 订单 流水 进行 统计 操作 ， 所 以 需要 自 定义 mapper 用 来 操作 数据 库 ， 在 resources/ 


<!DOCTYPE mapper PUBLIC "~//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis—3— 


mapper.dtd" > 
<mapper 
namespace="com.javadevmap.elasticjobexample.model.mapper.O: 
<resultMap id="StatisResultMap" 


—" 


rderManualMapper"> 


type="com.javadevmap.elasticjobexample.model.OrderStatis"> 
<result column="total" property="priceTotal" jdbcType="DOUBLE" /> 
<result column="cou" property="count" jdbcType="INTEGER" /> 


</resultMap> 

<sql id="Example_Where_Clause"> 
</sql> 

<select id="getOrderStatis" 


parameterType=" 
resultMap="StatisResultMap"> 


com.javadevmap.elasticjobexample.model.OrderJobExample" 


select COALESCE(SUM(price),0) as total, COUNT(1) as cou from order_job 


<if test="_parameter != null"> 
<include refid="Example_ Where Clause" /> 
</i> 
</select> 
</mapper> 


在 上 面 的 SQL 语句 中 ，select 方法 主要 查询 当天 订单 的 总 金额 


和 订单 总 数 。 


添加 resultMap 对 应 的 数据 类 型 ， 此 类 型 用 于 承接 数据 库 查 询 3 


下 的 数据 。 


public class OrderStatis { 
private Double priceTotal; 
private Long count; 
//... 省 上 略 get 与 set 方法 
@Override 
public String toString() { 


return "pricetotal = " + priceTotal + " count = " + count; 


} 
添加 OrderManualMapper 接口 ， 用 于 映射 select 方法 。 
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public interface OrderManual Mapper { 
public OrderStatis getOrderStatis(OrderJobExample example); 


} 
(3) 添加 数据 操作 类 
添加 接口 类 OrderDao? 和 实现 类 OrderDaoImpl， 用 于 操作 自 定义 mapper 及 设置 逻辑 查询 
条 件 。 


TT 


@Repository 

public class OrderDaoImpl implements OrderDao { 
@Autowired 
private OrderManualMapper manualMapper; 


@Override 
public OrderStatis getStatis() { 
OrderJobExample example = new OrderJobExample(); 
OrderJobExample.Criteria criteria = example.createCriteria(); 
DateFormat format = new SimpleDateFormat("yyyy- MM-—dd"); 
Date date = null; 
try { 
date = format.parse(format.format(new Date())); 
} catch (Exception e) { 
e.printStackTrace(); 


j 


criteria.andCreatetimeGreaterThanOrEqualTo(date); 
OrderStatis statis = manualMapper.getOrderStatis(example); 
return statis; 


} 
在 getStatis 方法 中 ， 获 取 当天 时 间作 为 查询 条 件 ， 然 后 使 用 自 定义 mapper 查询 当天 平台 
内 的 订单 总 体 情况 并 且 返 回 。 
(4) 添加 定时 任务 
添加 一 个 定时 任务 ， 此 任务 每 10s 执行 一 次 ， 查 询 并 且 显示 平台 内 的 订单 总 体 信息 。 


@Component 


public class TimedTask { 
@Autowired 
private OrderDao dao; 


@Scheduled(cron="0/10 * * * * 2") 
public void getStatis() { 
System.out.println(dao.getStatis()); 


O 本 章 展示 的 代码 中 省 略 了 OrderDao 接口 类 的 代码 。 
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执行 程序 后 ， 向 数据 库 中 添加 一 个 订单 ， 可 以 看 到 如 下 输出 : 


pricetotal = 0.0 count = 0 


pricetotal = 25.6 count = 1 


使 用 此 定时 任务 ， 可 以 实时 查看 平台 内 的 订单 情况 ， 类 似 于 双 十 一 实时 查看 订单 交易 额 。 


16.2 Cron 配置 
Cron 表达 式 由 6 到 7 个 时 间 元 素 组 成 ， 每 个 字符 表示 一 个 时 间 人 含义， 从 左 到 右 〈 用 空格 
隔 开 ) 依次 表示 为 : 
B® 分 小 时 月 份 中 的 日 期 月 份 星期 年 从 
(1) 各 字段 允许 的 值 及 允许 的 特殊 字符 见 表 16-1。 


表 16-1 Cron TA 


字 B 允 许 值 允许 的 特殊 字符 

秒 (Seconds) 0~59 的 整数 ao 个 字符 

分 (Minutes) 0~59 的 整数 so */ 个 字符 

小 时 (Hours) 0~23 的 整数 so */ 个 字符 
期 (DayofMonth) 1~31 的 整数 (与 月 份 有 关 ) ,-*?/LWC  ” 八 个 字符 

月 份 (Month) 1~12 的 整数 或 者 JAN-DEC ,—*/ 个 字符 
星期 (DayofWeek) 1~7 的 整数 或 者 SUN-SAT (1=SUN) ,一 *?/LC# ” 八 个 字符 

年 (可 选 ) (Year) 1970~2099 ,一 */ 个 字符 


(2) 各 特殊 字符 的 含义 如 下 : 
1) *: 表示 匹配 该 域 的 任意 值 ， 假 如 在 Minutes 域 使 用 *， 则 表示 每 分 钟 都 会 触发 事件 。 
2) ?: 只 能 用 在 DayofMonth 和 DayofWeek 两 个 域 。 如 果 在 其 中 一 个 域 设置 了 值 ， 那 么 另 
一 个 域 需要 使 用 “?” 符 号 ， 因 为 它们 会 互相 影响 。 
3) -: 表示 范围 ， 例 如 在 Minutes 域 使 用 5-20， 表 示 从 5 分 到 20 分 每 分 钟 触发 一 次 。 
4) /: 表示 起 始 时 间 开 始 触发 ， 然 后 每 隔 固定 时 间 触 发 一 次 ， 例 如 在 Minutes 域 使 用 5/20, 
则 表示 第 5 分 钟 触发 一 次 ， 每 隔 20 分 钟 触发 一 次 ， 即 25，45 分 别 触发 一 次 。 
5) ,: 表示 列 出 枚 举 值 。 例 如 : 在 Minutes 域 使 用 5,20， 则 表示 在 5 和 20 分 钟 触发 一 次 。 
6) L: 表示 最 后 ， 只 能 出 现在 DayofWeek 和 DayofMonth 域 ， 如 果 在 DayofWeek 域 使 用 
6L， 意 味 着 在 最 后 一 个 星期 五 触发 。 
DW: 表示 有 效 工作 日 (周一 到 周 五 );， 只 能 出 现在 DayofMonth 域 ， 系 统 将 在 离 指定 日 
期 最 近 的 有 效 工 作 日 触发 事件 。 例 如 : 在 DayofMonth 使 用 SW， 如 果 5 日 是 星期 六 ， 则 将 在 
最 近 的 工作 日 : 星期 五 ， 即 4 日 触发 。 如 果 5 日 是 星期 天 ， 则 在 6 日 (星期 一 ) 触发 ， 如 果 5 
在 星期 一 到 星期 五 中 的 某 天 ， 就 在 5 日 触发 。 请 注意 W 的 最 近 寻 找 不 会 跨 过 月 份 。 
8) LW: 这 两 个 字符 可 以 连用 ， 表 示 在 某 个 月 最 后 一 个 工作 日 。 
9) #: 用 于 确定 每 个 月 第 几 个 星期 几 ， 只 能 出 现在 DayofWeek 域 。 例 如 4# 表示 某 月 的 
第 二 个 星期 三 。 
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(3) 表达 式 举 例 


见 


第 


表 16-2 Cron 表达 式 


16 章 


mr 


定时 任务 


K 达 式 we X 
0021*?* 表示 在 每 月 的 1 日 凌晨 2 点 
0 15 9 ? * MON-FRI 表示 周一 到 周 五 每 天 上 午 9:15 
00 9,14,16 * *? 表示 每 天 上 午 9 点 ， 下 午 2 点 ，4 点 
0 0/30 9-17 * *? 表示 朝 九 晚 五 时 间 内 每 半 小 时 
0012**? 表示 每 天 中 午 12 点 
0159**?2018 表示 2018 年 的 每 天 上 午 9:15 
0*14**? 表示 在 每 天 下 午 2 点 到 下 午 2:59 期 间 的 每 1 分 钟 
00-5 14**? 表示 在 每 天 下 午 2 点 到 下 午 2:05 期 间 的 每 1 分 钟 
0 10,45 14? 3 WED 表示 每 年 三 月 的 每 个 星期 三 的 下 午 2:10 和 2:45 
015915*? 表示 每 月 15 日 上 午 9:15 
0159L*? 表示 每 月 最 后 一 日 的 上 午 9:15 
01592*6L 表示 每 月 的 最 后 一 个 星期 五 上 午 9215 
0 15 9 ? * 6L 2018-2025 表示 2018 年 至 2025 年 的 每 月 的 最 后 一 个 星期 五 上 午 9:15 
0159? * 6#3 表示 每 月 的 第 三 个 星期 五 上 午 9:15 
如 果 对 cron 表达 式 不 够 熟悉 ， 可 以 在 网 上 搜索 在 线 的 cron 表达 式 生成 器 。 


16.3 ElasticJob 介绍 


订单 允许 有 
个 良好 的 


在 上 面 定义 的 数据 库 9 


购物 体验 或 者 为 了 促使 订 六 


FH 


lity BEA 


E 订 单 失 效 前 提示 有 


上 户 支付 订 


P， 记 录 了 订单 的 基本 信 ， 
HPA 48 小 时 的 支付 时 间 2， 如 果 超 过 48 小 时 未 支付 则 订单 失效 。 
能 够 成 交 ， 还 是 希望 用 户 能 够 在 规定 时 间 内 文 付 订单 ， 这 
和 。 为 了 达到 此 目的 ， 一 般 会 使 用 定时 任务 轮流 查询 未 文 


5i 


Dv 


Hı 


一 


包含 了 用 户 是 否 已 经 支付 的 状态 ， 
为 了 让 用 户 有 


付 订 单 ， 然 后 提示 用 户 支 付 。 
使 用 前 面 介绍 的 定时 任务 方法 ， 确 实 能 够 实现 此 目的 ， 但 是 存在 以 下 问题 : 
E 当 只 启动 一 个 定时 任务 程序 时 ， 虽 然 最 终 能 够 达到 通知 用 户 的 目的 ， 但 是 时 效 性 是 个 
问题 ， 单 一 程序 裔 历 列表 并 且 实 现 通 知 的 时 间 较 长 。 
E 当 为 了 提高 执行 速度 ， 启 动 多 个 定时 任务 程序 时 ， 集 群 中 的 服务 无 法 知道 其 他 服务 是 
否 已 经 执行 了 通知 罗 辑 ， 即 多 个 定时 任务 之 间 如 何 协 作 是 个 问题 。 
针对 以 上 两 个 问题 ，ElasticJob 使 用 了 非常 简单 的 方法 就 实现 了 多 个 定时 任务 间 的 协作 ， 
从 而 提高 了 执行 速度 。 它 的 原理 非常 简单 ， 对 要 执行 的 任务 设 定 分 片 总 数 ， 然 后 多 个 任务 实例 
通过 ElasticJob 获取 各 自 的 分 片 信息 ， 根 据 自 己 的 分 片 信息 执行 对 应 的 数据 部 分 ， 从 而 实现 了 
横向 扩容 的 能 力 。 
O 因为 订单 是 占用 商品 库存 的 ， 如 果 用 户 长 时 间 不 支付 会 使 商品 数量 被 未 生效 订单 占用 但 是 又 无 法 卖 出 ， 这 是 不 符合 商家 利 


蔓 的 ， 所 以 订单 都 


会 有 一 个 超时 时 间 。 
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ElasticJob 是 一 个 开源 的 分 布 式 任务 框架 ， 它 使 用 Zookeeper 作为 各 分 片 任务 的 信息 管理 
中 心 ， 各 任务 节点 的 分 片 信息 可 以 通过 Zookeeper 进行 查看 。 
ElasticJob 的 作用 是 根据 分 片 总 数 为 每 个 定时 任务 的 实例 分 配 准 确 的 片段 值 。ElasticJob 不 负 
责 定 时 任务 获取 到 分 片 值 之 后 的 业务 逻辑 处 理 。 举 例 来 说 ， 现 在 设 定 ElasticJob 的 总 分 片 值 是 
2， 同 时 启动 两 个 定时 任务 服务 A 和 B，ElasticJob 会 保证 给 A 和 B 分 配对 应 的 1 和 2 这 两 个 
值 ， 至 于 A SBT 1 之 后 应 该 怎么 执行 逻辑 ， 这 是 编程 者 要 自己 定义 的 。 例 如 在 A 服务 中 拿 到 
了 1 这 个 分 片 ， 可 以 选择 数据 库 中 userid 对 总 数 2 取 模 后 等 于 1 的 数据 进行 处 理 。 
ElasticJob 支持 几 种 任务 模式 ， 下 面 主要 介绍 Simple 类 型 作业 和 Dataflow 类 型 作业 。 这 两 
种 作业 模式 都 需要 在 工程 中 引入 如 下 依赖 。 
<dependency> 
<groupId>com.dangdang</groupId> 
<artifactId>elastic-job-lite-core</artifactId> 
<version>2.1.5</version> 
</dependency> 
<dependency> 
<groupId>com.dangdang</groupId> 
<artifactld>elastic_job-lite-spring</artifactld> 
<version>2.1.5</version> 
</dependency> 


ho 


引入 依赖 后 ， 在 yml 配置 文件 中 添加 注册 中 心 Zookeeper 的 信息 : 
regCenter: 


serverList: 39.106.10.196:2181 
namespace: Jdmelasticjob 


添加 注册 信息 配置 类 : 


@Configuration 
@ConditionalOnExpression("'$ {regCenter.serverList}' length() > 0") 
public class RegistryCenterConfig { 
@Bean(initMethod = "init") 
public ZookeeperRegistryCenter regCenter(@Value("$ {regCenter.serverList}") final String serverList, 
@Value("$ {regCenter.namespace}") final String namespace) { 


return new ZookeeperRegistryCenter(new ZookeeperConfiguration(serverList, namespace)); 


} 
} 
添加 任务 记录 配置 : 
@Configuration 
public class JobEventConfig { 
@Resource 
private DataSource dataSource; 
@Bean 
public JobEventConfiguration jobEventConfiguration() { 
return new JobEventRdbConfiguration(dataSource); 
} 
} 


完成 如 上 几 步 ， 此 工程 就 实现 了 ElasticJob 的 基本 信息 配置 ， 下 面 就 可 以 根据 不 同 的 任务 


类 型 编写 不 同 的 代码 了 。 


16.4 


使 


简单 任务 
用 简单 任务 只 需要 配置 此 任务 的 总 体 分 片 规则 和 时 间 调度 规则 ， 然 后 实现 任务 的 配置 


类 ， 最 后 在 真正 执行 任务 逻辑 的 类 中 继承 SimpleJob 接口 类 ， 并 且 实 现 其 execute 方法 ， 这 样 
就 完成 了 简单 任务 
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ET 


全 部 工作 。 


C1) 时 间 及 分 片 设置 
在 yml 文件 中 添加 如 下 信息 : 


simpleJob: 
cron: 0 0 0/1 * *? 
shardingTotalCount: 3 
shardingItemParameters: 0=A,1=B,2=C 


使 用 此 配置 ， 设 定 任务 总 体 分 片 数 为 3， 每 个 小 时 执行 一 次 定时 任 


上 


(2) 添加 配置 类 


@Configuration 
public class SimpleJobConfig { 
@Resource 
private ZookeeperRegistryCenter regCenter; 


@Resource 
private JobEventConfiguration jobEventConfiguration; 


@Bean 
public SimpleJob simpleJob() { 
return new SpringSimpleJob(); 


} 


@Bean(initMethod = "init") 
public JobScheduler simpleJobScheduler(final SimpleJob simpleJob, 
@Value("$ {simpleJob.cron}") final String cron, 


F 


@Value("$ {simpleJob.shardingTotalCount}") final int shardingTotalCount, 
@Value("$ {simpleJob.shardingItemParameters}") final String shardingItemParameters) { 


return new SpringJobScheduler(simpleJob, regCenter, 
getLiteJobConfiguration(simpleJob.getClass(), 


cron, shardingTotalCount, shardingItemParameters), 


jobEventConfiguration); 


} 


private LiteJobConfiguration getLiteJobConfiguration(final Class<? extends SimpleJob> jobClass, final 
String cron, final int shardingTotalCount,final String shardingItemParameters) { 


return LiteJobConfiguration.newBuilder( 


new SimpleJobConfiguration(JobCoreConfiguration.newBuilder( 


jobClass.getName(), cron, 


shardingTotalCount).shardingItemParameters(shardingItemParameters).build(), 


jobClass.getCanonicalName())).overwrite(true).build(); 
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此 类 根据 之 前 设置 的 配置 项 和 新 创建 的 定时 任务 对 象 局 动 调 度 执 行 。 
(3) 定义 定时 任务 执行 逻辑 
public class SpringSimpleJob implements SimpleJob{ 


@Autowired 
private OrderDao dao; 


@Override 
public void execute(ShardingContext shardingContext) { 

int total = shardingContext.getShardingTotalCount(); 

int cur = shardingContext.getShardingItem(); 

System.out.println(String.format("SpringSimpleJob----—— Thread ID: %s, 
前 分 片 项 : %s", Thread.currentThread().getId(Q), total, cur)); 

System.out.println("SpringSimpleJob: " + Thread.currentThread().getId() + 
list is "+ dao.getTimeoutUserld(total, cur)); 


} 


NS 


} 


数 ， 并 且 使 用 数据 操作 类 OrderDao 获取 即将 支付 超时 的 用 户 id。 
(4) 基于 当前 分 片 数 的 数据 处 理 


FS 


后 根据 这 两 个 参数 进行 数据 查询 ， 获 取 用 户 id。 
public List<Long> getTimeoutUserld(int total,int cur) { 
Map<Object, Object> map = new HashMap<Object, Object>(); 
map.put("total" total); 
map.put("cur", cur); 
List<Long> list = manualMapper.getUnpaidUser(map); 
return list; 


(5) HX mapper 


<select id="getUnpaidUser" parameterType="Map" resultType="java.lang.Long"> 
select DISTINCT userid from order_job where status=0 and 
mod(userid,# {total ,jdbcType=INTEGER})=# {cur,jdbcType=INTEGER} and 
TIMESTAMPDIFF(Hour,createtime, NOW())>=47 

</select> 


自 定义 Mapper 类 映射 的 接口 方法 为 
public List<Long> getUnpaidUser(Map<Object, Object> map); 


任务 总 片 数 : Ns, 


" cur =" + cur +" 


此 类 是 真正 定时 任务 执行 业务 逻辑 的 地 方 ， 在 execute 方法 中 打印 了 总 分 片 数 和 当前 分 片 


在 OrderDaolmpl 类 中 添加 如 下 方法 ， 此 方法 接收 两 个 参数 : 总 分 片 数 和 当前 分 片 数 ， 然 


期 未 支付 订单 的 


此 语句 的 目的 是 查询 userid 对 总 分 片 数 取 模 等 于 此 任务 的 分 片 值 的 即将 到 
userid. 
(6) 运行 情况 演示 


运行 一 个 定时 任务 实例 ， 当 达到 时 间 规 则 时 ， 可 以 看 到 如 下 输出 ; 
SpringSimpleJob- 一 一 - Thread ID: 51, 任务 总 片 数 : 3， 当 前 分 片 项 : 2 
SpringSimpleJob- 一 一 - Thread ID: 50, 任务 总 片 数 : 3， 当 前 分 片 项 : 1 
SpringSimpleJob- 一 一 - Thread ID: 49, 任务 总 片 数 : 3， 当 前 分 片 项 : 0 


SpringSimpleJob: 50 cur = 1 list is [7, 10, 1, 4, 37] 
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SpringSimpleJob: 49 cur = 0 list is [6, 3, 33, 12, 9, 15, 18] 
SpringSimpleJob: 51 cur = 2 list is [2, 5, 8, 23, 11, 98, 17] 


由 上 面 的 输出 可 见 ， 返 回 的 userid 对 3 取 模 等 于 它 的 分 片 数 ， 即 各 个 分 片 根据 研发 者 定义 


的 逻辑 ， 处 理 自己 分 片 相应 的 数据 内 容 。 


如 果 再 启动 一 个 任务 实例 ， 那 么 新 启动 的 实例 就 会 分 担 全 部 分 片 中 某 些 分 片 的 任务 ， 这 样 


就 实现 了 档 


RAD REN AA. 


16.5 AREZ 


流 式 任务 与 简单 任务 不 同 的 地 方 是 此 任务 的 逻辑 实现 类 要 继承 DataflowJob 接口 类 ， 此 接 
类 中 包含 两 个 方法 : fetchData 和 processData。fetchData 方法 负责 数据 抓 取 ，processData 方 
法 负责 对 抓 取 到 的 数据 进行 处 理 。 当 流 式 处 理 数据 时 ， 上 只 有 当 fetchData 方法 返回 null 或 空 


List 时 作业 才 人 停止， 否则 作业 会 一 直 执行 下 去 。 


FAA 


E 务 比较 适用 于 在 某 一 时 刻 ， 利 用 流 式 任务 不 停 执行 的 特性 ， 进 行 不 间断 的 大 量 数据 
处 理 的 工作 。 下 面 编写 一 个 例子 ， 让 流 式 任 务 在 每 天 2 点 统计 前 一 天 每 个 用 户 的 购买 情 攻 


Lo 


C1) 时 间 及 分 片 设置 


在 yml 文件 中 添加 如 下 内 容 。 


dataflowJob: 


cron: 002**? 
shardingTotalCount: 3 
shardingItemParameters: 0=A,1=B,2=C 


使 用 此 配置 ， 设 定 任务 总 体 分 片 数 为 3， 每 天 2 点 执行 任务 。 
(2) 添加 配置 类 

@Configuration 

public class DataflowJobConfig { 


@Resource 
private ZookeeperRegistryCenter regCenter; 


@Resource 
private JobEventConfiguration jobEventConfiguration; 


@Bean 
public DataflowJob dataflowJob() { 
return new SpringDataflowJob(); 


} 


@Bean(initMethod = "init") 

public JobScheduler dataflowJobScheduler(final DataflowJob dataflowJob, 

@Value("$ {dataflowJob.cron}") final String cron, 

@Value("$ {dataflowJob.shardingTotalCount}") final int shardingTotalCount, 

@Value("$ {dataflowJob.shardingItemParameters}") final String shardingItemParameters) { 

return new SpringJobScheduler(dataflowJob, regCenter, 

getLiteJobConfiguration(dataflowJob.getClass(), cron, 
shardingTotalCount, shardingItemParameters), jobEventConfiguration); 
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private LiteJobConfiguration getLiteJobConfiguration(final Class<? extends DataflowJob> jobClass, final 


String cron, final int shardingTotalCount, final String shardingItemParameters) { 
return LiteJobConfiguration.newBuilder( 


new DataflowJobConfiguration(JobCoreConfiguration.newBuilder( 


jobClass.getName(), cron, 


shardingTotalCount).shardingItemParameters(shardingItemParameters).build(), 


jobClass.getCanonicalName(), true)).overwrite(true).build(); 


} 
此 类 根据 之 前 设置 的 配置 项 和 新 创建 的 定时 任务 对 象 局 动 调 度 执 行 。 
(3) 定义 定时 任务 执行 逻辑 

public class SpringDataflowJob implements DataflowJob { 


@Autowired 
private OrderDao dao; 


@Override 

public List fetchData(ShardingContext shardingContext) { 
int total = shardingContext.getShardingTotalCount(); 
int cur = shardingContext.getShardingItem(); 


System.out.println(String. format("SpringDataflowJob fetchData -一 


总 片 数 : %s， 当 前 分 片 项 : %s", Thread.currentThread().getld(),total, cur)); 
return dao.getStatisList(total, cur); 


j 


@Transactional 

@Override 

public void processData(ShardingContext shardingContext, List data) { 
int total = shardingContext.getShardingTotalCount(); 
int cur = shardingContext.getShardingItem(); 


System.out.println(String.format("SpringDataflowJob processData — 


务 总 片 数 : %s， 当 前 分 片 项 : %s", Thread.currentThread().getId(), total, cur)); 
//todo sth; 
dao.completeStatis(data); 


} 


SpringDataflowJob 类 定义 了 定时 任务 执行 的 逻辑 ， 其 中 fetchData 方法 用 于 分 批 次 从 数据 
库 中 查询 前 一 天 的 订单 列表 ; processData 方法 根据 查询 到 的 数据 进行 统计 ， 代 码 中 的 注释 部 


——-Thread ID: %s, 任务 


—---- Thread ID: %s, 任 


a “todo sth;” 表 示 可 以 把 统计 数据 存 入 另外 一 个 统计 表 中 ， 这 里 同 于 篇 


eA BOY, Ay 


以 到 随 书 附带 的 工程 中 查看 。processData 方法 最 后 调用 dao.completeStat 


is(data) 方 法 ， 用 于 对 


已 经 处 理 完 的 数据 设置 标记 位 ， 避 免 再 次 被 fetchData 方法 查询 出 已 经 处 到 


过 的 数据 。 


(4) 数据 查询 及 处 理 


用 户 的 未 统计 订单 ， 


在 OrderDaoImpl 中 添加 如 下 方法 ，getStatisList 方法 负责 查询 
completeStatis 方法 用 于 对 已 经 统计 完 的 数据 设置 标记 位 。 


@Autowired > 
private OrderJobMapper mapper; 


© 此 mapper 是 使 用 Mybatis 自动 生成 的 mapper。 
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public List<OrderJob> getStatisList(int total,int cur) { 
Map<Object, Object> map = new HashMap<Object, Object>(); 
map.put("total" total); 
map.put("cur", cur); 
List<Long> userlist = manualMapper.getStatisUser(map); 


if(!userlist.isEmpty()) { 
Map<Object, Object> listmap = new HashMap<Object, Object>(); 
listmap.put("List" userlist); 
List<OrderJob> list = manualMapper.getStatisOrder(listmap); 
return list; 
} 
return null; 
} 
public void completeStatis(List<OrderJob> list) { 
for (OrderJob orderJob : list) { 
orderJob.setStatis(true); 
mapper.updateByPrimaryKey(orderJob); 


(5) 自 定 义 的 mapper 
在 查询 未 统计 订单 时 ， 使 用 了 自 定 义 的 SQL 查询 方法 ， 代 码 如 下 。 
<select id="getStatisUser" parameterType="Map" resultType="java.lang.Long"> 
select DISTINCT userid from order_job where statis=0 and 
mod(userid,# {total ,jdbcType=INTEGER})=# {cur,jdbcType=INTEGER} and 
to_days(createtime)=to_days(DATE_SUB(CURDATE(), INTERVAL 1 DAY)) limit 
10 
</select> 


<select id="getStatisOrder" parameterType="Map" resultMap="BaseResultMap">° 
select id, price, userid, status, createtime, statis from order_job 
where statis=0 and 
to_days(createtime)=to_days(DATE_SUB(CURDATEQ(), INTERVAL 1 DAY)) and 
userid in 
<foreach item="item" index="index" collection="list" open="(" 
separator="," close=")"> 
# {item} 
</foreach> 
</select> 


自 定义 Mapper 类 映射 的 接口 方法 为 


public List<Long> getStatisUser(Map<Object, Object> map); 
public List<OrderJob> getStatisOrder(Map<Object, Object> map); 


至 此 ， 使 用 DataflowJob 形式 的 定时 任务 编写 完成 ， 它 会 在 每 天 2 点 统计 前 一 天 的 业务 数 
据 ， 可 以 让 你 在 第 二 天 上 班 时 看 到 前 一 天 详细 的 业务 情况 ， 给 业务 的 发 展 以 数据 的 支持 。 


此 处 用 于 演示 ， 所 以 没有 对 订单 的 支付 状态 进行 第 选 ， 实 际 业 务 中 的 查询 逻辑 要 比 这 个 复杂 ; BaseResultMap 的 定义 和 
Mybatis 自动 生成 的 相同 ， 记 得 将 Mybatis 自动 生成 的 BaseResultMap 的 定义 引入 进 此 文件 。 
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RabbitMQ 


对 于 某 些 时 限 要 求 不 高 的 业务 ， 或 者 为 了 降低 后 端 服务 压力 的 情况 ， 可 能 会 用 到 消息 队 
列 。 消 息 队 列 就 像 一 个 仓储 或 者 转运 中 心 ， 某 些 服务 需要 处 理 一 些 事务 ， 但 是 又 不 急于 得 到 返 


回 ， 或 者 能 够 处 理 此 事务 的 服务 由 于 各 种 原 
消息 队列 ， 然 后 由 能 够 处 理 此 事务 的 服务 从 
队列 在 此 种 情形 下 达到 了 解 耦 、 暂 存 、 削 峰 


RabbitMQ 是 实现 了 AMQPS 协 议 的 消息 中 间 件 的 一 种 ， 易 用 性 、 扩 展 性 、 高 可 上 


因 不 能 立刻 返回 ， 这 种 情况 下 就 会 把 这 个 事务 
消息 队列 中 获取 需要 执行 的 事务 再 执行 。 所 以 
的 目的 。 


放 入 


消息 


好 ， 同 时 支持 多 种 客户 端 ， 如 Python, Java, PHP. C 等 。 本 章 介绍 RabbitMQ 的 主要 用 法 。 


17.1 队列 传递 字符 串 


新 建 两 个 Spring Boot 服务 ， 一 个 服务 用 于 向 消息 队列 中 添加 消息 ， 男 一 个 服务 负责 


从 消 


息 队 列 中 获取 消息 并 且 进 行 处 理 。 发 送 消息 的 服务 命名 为 RabbitMQSender， 处 理 消息 的 服务 
命名 为 RabbitMQReceiver。 服 务 间 传递 的 消息 是 一 个 String 类 型 的 字符 串 。 


17.1.1 消息 队列 基本 配置 
引入 消息 队列 非常 简单 ， 只 要 添加 消息 


队列 的 工程 依赖 ， 并 且 配 置 消息 队列 的 连接 信息 


可 。 在 两 个 服务 中 配置 同样 的 基础 信息 ， 有 具体 如 下 。 


(1) 添加 消息 队列 依赖 


<dependency> 


在 两 个 工程 的 pom 文件 中 ， 添 加 如 下 依赖 : 


<groupId>org.springframework.boot</groupId> 
<artifactld>spring-boot-starter-amaqp</artifactld> 


</dependency> 


(2) 添加 消息 队列 配置 


Spring: 
rabbitma: 
host: 39.106.10.196 
port: 5673 
username: guest 
password: guest 


在 yml 文件 中 ， 添 加 如 下 RabbitMQ 的 连接 配置 : 


如 果 此 服务 在 一 个 Spring Cloud RPE 


， 并 且 集 群 中 已 经 通过 RabbitMQ 进行 了 信息 


的 搜 


集 ， 例 如 把 链 路 监控 信息 通过 RabbitMQ 传 到 Zipkin 中 ， 那 么 上 面 的 配置 和 Zipkin 的 消息 队 


列 的 配置 可 以 共用 ， 不 用 重复 添加 。 


© 即 Advanced Message Queuing Protocol， 高 级 消息 队列 协议 ， 是 应 用 层 协议 的 一 个 开放 标准 ， 为 面向 消息 的 中 间 件 设计 。 
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17.1.2 ”发 送 方 配置 及 使 用 
在 发 送 方 ， 需 要 配置 消息 队列 中 的 具体 接收 消息 的 队列 ， 然 后 向 此 队列 发 送 String 类 型 的 


消息 。 
a) 队列 配置 
在 工程 中 添加 配置 类 RabbitmqConfig， 然 后 添加 如 下 内 容 : 


@Configuration 
public class RabbitmqConfig { 
//message queue KKK Kk K kK KK KK 3K 2K K 2K K 2k K 2K 3K 2 ok ok K 
@Bean 
public Queue StringQueue() { 
return new Queue("StringQueue"); 


j 
j 


这 样 ， 就 定义 了 RabbitMQ 的 队列 名 称 为 StringQueue。 
(2) 添加 发 送 逻 辑 
新 建 一 个 专门 用 于 向 RabbitMQ 发 送 消息 的 类 RabbitmqSender ， 在 此 类 中 添加 向 
RabbitMQ 发 送 消息 的 方法 ， 有 共 体 如 下 : 
@Repository 
public class RabbitmqSender { 
@Autowired 
private AmqpTemplate rabbitTemplete; 


public String sendString() { 
rabbitTemplete.convertAndSend("StringQueue","string message send"); 
return "string send ok!"; 


} 
新 建 一 个 Controller 类 ， 此 类 中 提供 一 个 接口 ， 
使 用 如 上 方法 向 RabbitMQ 中 发 送 一 条 消息 。 
@RestController 
@RequestMapping(value="/rabbitsender") 
public class RabbitMQController { 


@Autowired 
private RabbitmqSender sender; 


| 由 


用 HTTP 请 求 调 用 此 接口 时 ， 此 接口 会 


@RequestMapping(value="/sendMessage",method=RequestMethod.GET) 
public Result<String> sendMessage() { 

String ret = sender.sendString(); 

Result<String> result = new Result<>(ResultCode.OK, ret); 

return result; 


} 


启动 发 送 方 服务 ， 调 用 如 上 接口 ， 可 以 在 RabbitMQ 的 StringQueue 队列 中 看 到 相应 变 
化 ， 如 图 17-1 所 示 。 
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Overview Connections Channels Exchanges Admin 


Queue StringQueue 
Overview 


Queued messages (chart: last minute) 

1.5 

1.0 

0.5 Unacked 


Ready 1 


15:34:1015:34:2015:34:3015:34:4015:34:5015:35:00 Total ml 


Publish 0.00/s 


Deliver 
(manual 0.00/s 
5:34:1015:34:2015:34:3015:34:4015:34:50 ack) 


Deliver 
(auto ack) 


图 17-1 消息 队列 接收 消息 


E 0.00/s 


17.1.3 ”接收 方 配置 及 使 用 


在 接收 方 ， 需 要 做 的 是 把 接收 逻辑 与 RabbitMQ 中 的 队列 绑 定 ， 当 队列 中 有 待 处 理 消息 
时 ， 接 收 方 从 中 获取 消息 并 且 进 行 处 理 。 

C1) 队列 配置 
在 工程 中 添加 配置 类 RabbitmqConfig， 然 后 添加 如 下 内 容 : 


@Configuration 
public class RabbitmqConfig { 
//message queue 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 
@Bean 
public Queue StringQueue() { 
return new Queue("StringQueue"); 


} 
} 


(2) 添加 队列 监听 ， 并 且 获 取消 息 进行 处 理 
添加 一 个 队列 监听 类 MessageReceiver， 此 类 通过 @RabbitListenere 注 解 监听 指定 的 队列 ， 
并 且 通 过 @RabbitHandler 注解 标注 的 方法 获取 队列 信息 进行 处 理 。 
@Component 
@RabbitListener(queues = "StringQueue") 
public class MessageReceiver { 
@RabbitHandler 
public void process(String message) { 
System.out.println(""messageReceiver: " + message); 


} 
j 


上 面 的 方法 中 ， 获 取消 息 队 列 中 的 消息 ， 并 且 输 出 至 控 和 
RabbitMQ 中 的 变化 ， 如 图 17-2 所 示 。 


= 


合 。 启 动 此 接收 服务 ， 可 以 看 到 


O 在 代码 中 可 以 点 击 此 注解 查看 其 注解 内 容 ， 其 使 用 范围 不 只 是 作用 于 类 之 上 。 
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bb Rabbit 


Overview Connections Channels Exchanges | Queues | Admin 
Queue StringQueue 
Overview 


Queued messages (chart: last 


1.5 


Ready 0 
1.0 
0.5 Unacked 0 
0.0 
15:47:3015:47:4015:47:5015:48:0015:48:1015:48:20 Total m0 
Message rates (chart: last 
Publish 0.00/s 
Deliver 
o/s (manual 0.00/s 
.0/s s 
15:47:3015:47:4015:47:5015:48:0015:48:1015:48:20 ack) 
Deliver peg 
(auto ack) E 0.00/s 


图 17-2 消息 队列 消息 消耗 


并 且 在 控制 台 输 出 如 下 内 容 : 


messageReceiver: string message send 


17.1.4 多 对 多 实现 


消息 队列 不 仅 可 以 应 用 于 一 对 一 的 场景 ， 还 可 以 实现 多 对 多 的 通信 。 可 以 有 多 个 消息 发 送 
方向 同一 队列 发 送 消 息 ， 可 以 有 多 个 消息 接收 方 从 同一 队列 中 获取 消息 ， 这 样 就 可 以 实现 消息 
队列 的 多 对 多 。 这 里 简单 演示 此 种 情况 。 

(1) 发 送 方 改造 

添加 一 个 RabbitmqSender2 类 ， 此 类 添加 一 个 发 送 方 法 ， 此 方法 需要 传 入 一 个 Index 参数 
用 于 消息 计数 ， 在 前 面 的 RabbitmqSender 类 中 也 同样 添加 此 方法 。 

@Repository 
public class RabbitmqSender2 { 


@Autowired 
private AmqpTemplate rabbitTemplete; 


public String sendString(int index) { 
rabbitTemplete.convertAndSend("StringQueue","string message send " + index); 
return "string send ok!"; 


} 
修改 Controller 类 ， 注 入 RabbitmqSender2 的 类 实例 ， 添 加 一 个 批量 发 送 的 方法 。 
@RequestMapping(value="/sendMultiMessage",method=RequestMethod.GET) 
public Result<String> sendMultiMessage() { 
for(int 1=0;i<10;1++) { 
sender.sendString(i); 
sender2.sendString(1); 
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Result<String> result = new Result<>(ResultCode.OK, "OK"); 
return result; 


} 


(2) 接收 方 改造 
在 接收 方 添加 另 一 个 类 MessageReceiver 2， 此 类 同 档 


@Component 
@RabbitListener(queues = "StringQueue") 
public class MessageReceiver2 { 
@RabbitHandler 
public void process(String message) { 
System.out.println(""messageReceiver2: " + message); 


TIT 


j 
j 
(3) 效果 演示 


17-3 所 示 。 


bb Rabbit 


监听 StringQueue 队列 。 


首先 启动 发 送 方 ， 然 后 调用 发 送 方 的 多 发 方法 ， 可 以 在 RabbitMQ 中 看 到 相应 变化 ， 


Overview Connections Channels Exchanges Queues Admin 
Queue StringQueue 
Overview 
Queued messages (chart: last n t 
30 Ready 20 
20 
15 
= Unacked 0 
0 
16:28:0016:28:1016:28:2016:28:3016:28:4016:28:50 Total E20 
Message rates 
Publish 0.00/s 
Deliver 
(manual 0.00/s 
ack) 
Deliver A 
(auto ack) | ™ 0-00/s 


图 17-3 ”消息 队列 中 收 到 的 消息 
启动 接收 方程 序 ， 可 以 在 控制 台 看 到 如 下 信息 输出 : 


messageReceiver: string message send 0 
messageReceiver: string message send 0 
messageReceiver: string message send 1 
messageReceiver2: string message send 1 
messageReceiver: string message send 2 
messageReceiver2: string message send 2 
messageReceiver: string message send 3 
messageReceiver2: string message send 3 


ho 
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17.2 ”队列 传递 对 象 


传递 的 对 象 需要 具备 相同 的 package 包 名 、 对 象 类 名 ， 
示 此 种 情况 。 


17.2.1 发 送 方 配置 及 使 用 


x 


类 中 添加 如 下 内 容 。 
//object queue 米 米 米 米 米 米 炒米 米 米 米 米 米 米 炒米 米 米 米 米 米 米 米 米 米 米 米 米 
@Bean 
public Queue ObjectQueue() { 
return new Queue("ObjectQueue"); 


j 


在 com.javadevmap.model 路 径 下 添加 UserModel 
实现 Serializable 接口 实现 序列 化 。 


public class UserModel implements Serializable { 
private static final long serial VersionUID = 1L; 
public String name; 
public int age; 
public String address; 
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使 用 RabbitMQ 不 仅 可 以 在 程序 间 实 现 消 息 的 传递 ， 还 可 以 传递 对 和 象 实例 ， 只 不 过 双方 间 


并 且 此 类 需 实现 序列 化 接口 。 下 面 来 演 


首先 配置 RabbitMQ 中 的 队列 ， 作 为 发 送 方 与 接收 方 数据 传递 的 通道 ， 在 Rabbitmq Config 


类 ， 此 类 是 对 象 传递 的 数据 结构 ， 通 过 


public UserModel(String name,int age,String address) { 


this.name = name; 
this.age = age; 
this.address = address; 

} 

@Override 

public String toString() { 


return "name = " + name + " age =" + age + " address = " + address; 


j 
j 


在 发 送 方 的 RabbitmqSender 类 中 添加 如 下 方法 ，| 
public String sendObject() { 


] 于 向 队列 中 发 送 对 象 数据 。 


UserModel user = new UserModel("javadev", 20, "java"); 
rabbitTemplete.convertAndSend("ObjectQueue",user); 


return "object send ok!"; 


} 


RabbitMQ 中 发 送 对 象 消 息 。 


在 Controller 类 中 添加 接口 ， 用 于 接收 HTTP 请 求 并 


< 


调用 消息 队列 的 发 送 方法 向 


@RequestMapping(value="/sendObject",method=RequestMethod.GET) 


public Result<String> sendObject() { 
String ret = sender.sendObject(); 


Result<String> result = new Result<>(ResultCode.OK, ret); 


return result; 
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17.2.2 ”接收 方 配置 及 使 用 
在 接收 方 的 RabbitmqConfig 类 中 添加 需要 监控 的 队列 。 


//object queue FKK KK KK KK K 3K 2K K K K 2g 3K 3K 3K 3K K K K K 2K 3K 2 2 3K 
@Bean 
public Queue ObjectQueue() { 

return new Queue("ObjectQueue"); 


} 


复制 发 送 方 的 UserModel 类 实现 ， 并 且 放 入 相同 的 package 路 径 下 ， 如 果 package 不 同 会 
出 现 无 法 解析 的 错误 。 然 后 添加 队列 监听 及 消息 处 理 类 ObjectReceiver， 其 具体 实现 如 下 。 


@Component 
@RabbitListener(queues = "ObjectQueue") 
public class ObjectReceiver { 
@RabbitHandler 
public void process(UserModel user) { 
System.out.println("ObjectReceiver: " + user.toString()); 


} 
} 
这 里 监听 ObjectQueue 队列 ， 如 果 队列 中 存在 数据 则 获取 数据 并 且 打 印 。 启 动 发 送 方 及 
接收 方 服务 ， 然 后 调用 发 送 方 的 接口 ， 可 以 在 接收 方 看 到 如 下 输出 ， 这 样 就 完成 了 对 和 象 数据 
的 传递 。 


ObjectReceiver: name = javadev age = 20 address = java 


17.3 ”队列 传递 Json 数据 


如 上 一 节 所 示 ， 使 用 对 象 传递 的 方式 ， 在 不 同 服务 间 传 递 数 据 ， 需 要 在 相同 的 路 径 下 创建 
相同 名 字 的 类 。 这 种 做 法 无 疑 会 增加 服务 间 的 看 合 ， 并 且 会 对 编程 工作 造成 一 些 不 必要 的 麻 
烦 。 所 以 可 以 使 用 另 一 种 方案 ， 在 发 送 方 把 对 象 数据 转 为 Ison 格式 ， 通 过 String 类 型 进行 传 
递 ， 在 接收 方 接收 String 类 型 的 数据 ， 再 把 Ison 数据 转化 为 对 象 ， 这 样 既 可 以 实现 对 象 数据 
的 传递 ， 也 可 以 降低 服务 问 的确 合 。 


17.3.1 发 送 方 配置 及 使 用 
在 发 送 方 的 RabbitmqConfig 类 中 添加 队列 信息 。 


//object json queue 
@Bean 
public Queue ObjectJsonQueue() { 
return new Queue("ObjectJsonQueue"); 


} 
添加 发 送 方 的 方法 ， 使 其 通过 ObjectIsonQueue 队列 传递 对 象 的 Ison 数据 。 


ObjectMapper mapper = new ObjectMapper(); 
public String sendObjectJson() { 
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try { 
UserModel user = new UserModel("javadev", 20, "java"); 
String msg = mapper.write ValueAsString(user); 
rabbitTemplete.convertAndSend("ObjectJsonQueue",msg); 
return "object json send ok!"; 

} catch (Exception e) { 
e.printStackTrace(); 
return "object json send fail!"; 


} 


在 Controller 类 中 添加 接口 方法 ， 使 其 可 以 调用 发 送 方法 发 送 Json 数据 。 


@RequestMapping(value="/sendObjectJson",method=RequestMethod.GET) 
public Result<String> sendObjectJson() { 

String ret = sender.sendObjectJson(); 

Result<String> result = new Result<>(ResultCode.OK, ret); 

return result; 


17.3.2 ”接收 方 配置 及 使 用 
在 接收 方 的 RabbitmqConfig 类 中 添加 需要 监听 的 队列 。 


/object json queue 
@Bean 
public Queue ObjectJsonQueue() { 
return new Queue("ObjectJsonQueue"); 


j 
ERRI ASIN AF E T AAEE E 


@Component 
@RabbitListener(queues = "ObjectJsonQueue") 
public class ObjectJsonReceiver { 

ObjectMapper mapper = new ObjectMapper(); 


@RabbitHandler 
public void process(String message) { 
System.out.println("ObjectJsonReceiver: " + message); 
try { 
UserModel user = mapper.readValue(message, UserModel.class); 
System.out.println(user); 
} catch (Exception e) { 
e.printStackTrace(); 
} 


j 
在 上 面 的 方法 中 ， 获 取 队 列 中 的 String 类 型 的 消息 ， 并 且 打 印 ， 然 后 把 其 转化 为 对 象 数 
据 ， 再 进行 输出 。 可 在 控制 台 看 到 如 下 信息 。 


ObjectJsonReceiver: {"name":"javadev","age":20,"address":"java" 
name = javadev age = 20 address = java 


O 


bs 
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17.4 Topic 模式 


之 前 使 用 RabbitMQ 的 方式 ， 都 是 在 发 送 方 直 接 向 绑 定 的 队列 发 送 消 息 ， 如 果 有 


案 ， 但 是 不 够 优雅 。RabbitMQ 使 用 了 交换 机 的 方式 ， 可 以 在 发 送 方 通过 交换 机 发 送 消息 
到 以 上 的 目的 ， 甚 至 可 以 配置 交换 机 的 发 送 规则 ， 有 选择 地 发 送 至 不 同 的 队列 。 


17.4.1 Topic 模式 讲解 


首先 在 发 送 方 的 RabbitmqConfig 类 中 添加 如 下 斩 


cu 
i 


/topic 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 
@Bean 
public Queue TopicMessageQueue() { 

return new Queue("Topic.MessageQueue"); 


} 


@Bean 
public Queue TopicAlIQueue() { 
return new Queue("Topic.AllQueue"); 


j 


@Bean 
public TopicExchange TopicExchange() { 
return new TopicExchange("TopicExchange"); 


} 


@Bean 


种 情 


况 ， 和 希望 发 送 方 的 消息 可 以 同时 向 不 同 的 队列 发 送 ， 那 么 逐个 队列 的 调用 确实 是 一 种 解决 方 


l, IK 


public Binding bindingExchangeMessage(Queue TopicMessageQueue, TopicExchange TopicExchange) { 


return BindingBuilder.bind(TopicMessageQueue). 
to(TopicExchange).with(""Topic.MessageQueue"); 
} 


@Bean 

public Binding bindingExchangeAll(Queue TopicAl|Queue, TopicExchange TopicExchange) { 
return BindingBuilder.bind(TopicAllQueue).to(TopicExchange).with("Topic.#"); 

j 


上 面 的 代码 中 ， 创 建 了 两 个 队列 Topic.MessageQueue 和 Topic.AllQueue， 创 建 了 一 个 交 


换 机 TopicExchange; 然后 通过 bind 方法 把 队列 和 交换 机 进行 绑 定 ， 此 绑 定 的 意义 如 图 


所 示 。 
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未 中 P 表示 生产 者 ，C 表示 消费 者 。 


匹配 规则 
Topic.MessageQueue 


| Topic. MessageQueue 
| Topic.AllQueue 
匹配 规则 Topic# 


图 17-4 Topic 模式 匹配 规则 


TopicExchange 


17-4 


列 选择 信息 发 送 到 不 同 
的 两 个 队列 都 能 
Topic.other， 那 么 上 图 


到 消息 。 


个 词 。 
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在 发 送 方 ， 向 TopicExchange 发 送 消 息 ， 同 时 要 指定 队列 选择 信息 ， 匹 配 规则 就 会 根据 队 
的 队列 。 例 如 指定 的 队列 选择 信息 是 Topic.MessageQueue， 那 么 上 图 中 
够 正确 匹配 ， 即 两 个 队列 都 能 够 收 到 信息 。 如 果 指 定 的 队列 选择 信息 是 


HAA Topic.AllQueue 能 够 匹配 此 规则 ， 即 只 


有 Topic.AllQueue 能 够 收 


在 编写 匹配 规则 时 ， 需 要 用 到 * 和 # 通 配 符 ，* 可 以 匹配 零 个 或 一 个 词 ，# 可 以 匹配 零 个 或 多 


通过 RabbitMQ 的 可 视 化 页 面 ， 查 看 Exchange 的 队列 绑 定 情况 ， 如 图 17-5 所 示 。 


出 Rabbit 


Overview Connections Channels Exchanges Queues Admin 


Exchange: TopicExchange 
Overview 


Message rates (chart: last minute) (? 


mys Publish 
0.4/s (In) 
San Publish 
mie :37:1018:37:2018:37:3018:37:4018:37:5018:38:00 (Out) 
18:37:1018:37:2018:37:3018:37:4018:37:5018:38:00 
Details 
Type topic 
Features durable: true 
Policy 
Bindings 
This exchange 
To Routing key Arguments 
Topic. # =R] 
Topic.AllQueue p | Unbind | 
Topic.MessageQueue ind | 
Topic.MessageQueue geQ [Unbind | 


图 17-5 消息 队列 绑 定 


17.4.2 ”发 送 方 配 置 及 使 用 


public String sendTopic() { 
rabbitTemplete.convertAndSend("TopicExchange", 
"Topic.MessageQueue", "topic message"); 
rabbitTemplete.convertAndSend("TopicExchange", "Topic.other", "topic all"); 
return "topic send ok!"; 


j 
以 上 代码 的 


0.00/s 


0.00/s 


在 发 送 方 添加 队列 、 交 换 机 及 绑 定 配置 后 ， 在 RabbitmgSender 类 中 添加 如 下 方法 。 


目的 ， 是 向 交换 机 TopicExchange 发 送 消息 ，convertAndSend 方法 的 第 二 个 参 
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数 指定 了 队列 选择 信息 ， 此 队列 选择 信息 会 由 交换 机 绑 定 队列 时 使 用 的 匹配 规则 进行 匹配 ， 找 
到 合适 的 队列 发 送 消息 。 
在 Controller 类 中 ， 添 加 如 下 接口 ， 用 以 调用 发 送 方 方 法 。 
@RequestMapping(value="/sendTopic",method=RequestMethod.GET) 
public Result<String> sendTopic() { 
String ret = sender.sendTopic(); 


Result<String> result = new Result<>(ResultCode.OK, ret); 
return result; 


17.4.3 ”接收 方 配置 及 使 用 


在 接收 方 首 先 配 置 监听 的 队列 ， 这 里 监听 两 个 队列 Topic.MessageQueue 和 Topic.All 
Queue， 所 以 要 在 RabbitmqConfig 类 中 添加 如 下 代码 。 
//topic 米 米 米 米 米 米 米 米 炒米 米 米 炒米 米 米 米 米 炒米 米 米 米 米 米 米 米 米 米 米 


@Bean 
public Queue TopicMessageQueue() { 
return new Queue(""Topic.MessageQueue"); 


} 


@Bean 
public Queue TopicAlIQueue() { 
return new Queue("Topic.AllQueue"); 


} 
添加 两 个 队列 监听 处 理 类 ， 分 别 实现 如 下 。 
@Component 


@RabbitListener(queues = "Topic.AllQueue") 
public class TopicAllReceiver { 
@RabbitHandler 
public void process(String message) { 
System.out.println("topicAllReceiver: " + message); 
} 
} 


@Component 

@RabbitListener(queues = "Topic. MessageQueue") 

public class TopicMessageReceiver { 
@RabbitHandler 
public void process(String message) { 

System.out.println(""topicMessageQueue: " + message); 

} 

} 


启动 发 送 方 和 接收 方 服 务 ， 然 后 调用 发 送 接口 ， 可 以 在 接收 方 的 控制 台 看 到 如 下 输出 。 
topicAllReceiver: topic message 


topicMessageQueue: topic message 
topicAllReceiver: topic all 


对 于 topic message 消息 ， 由 于 指定 的 队列 选择 信息 是 Topic.MessageQueue， 所 以 两 个 队列 
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规则 都 能 够 匹配 此 信息 ， 监 听 的 两 个 队列 都 能 够 打印 topic message 消息 ; 对 于 topic all 消息 ， 
由 于 指定 的 队列 选择 信息 是 Topic.other， 所 以 Topic.MessageQueue 规则 无 法 匹配 此 信息 ， 只 有 
Topic# 规 则 可 以 匹配 ， 结 果 只 有 Topic.AllQueue 队列 收 到 了 消息 。 


17.5 Fanout 模式 


Fanout 模式 与 Topic 模式 不 同 ， 不 需要 匹配 队列 规则 ， 只 要 绑 定 到 Fanout 交换 机 上 的 队 
列 都 能 够 收 到 发 送 到 交换 机 上 的 消息 。 


17.5.1 发 送 方 配置 及 使 用 


在 发 送 方 ， 只 需要 创建 好 队列 ， 将 队列 绑 定 到 FanoutExchange 上 ， 然 后 向 Fanout 
Exchange 发 送 消 息 ， 所 有 绑 定 的 队列 都 可 以 收 到 消息 。 

C1) 配置 队列 及 绑 定 
在 RabbitmqConfig 中 ， 添 加 如 下 代码 。 
//fanout 米 米 炒米 炒米 米 米 米 米 炒米 炒米 米 米 炒米 米 米 米 米 米 米 炒米 米 米 米 米 米 


@Bean 
public Queue AQueue() { 
return new Queue(""A Queue"); 


Mm 


} 


@Bean 
public Queue BQueue() { 
return new Queue("BQueue"); 


j 


@Bean 
public FanoutExchange FanoutExchange() { 
return new FanoutExchange("FanoutExchange"); 


} 


@Bean 
Binding bindingExchangeA(Queue AQueue,FanoutExchange FanoutExchange) { 
return BindingBuilder.bind(AQueue).to(FanoutExchange); 
} 


@Bean 
Binding bindingExchangeB(Queue BQueue,FanoutExchange FanoutExchange) { 
return BindingBuilder.bind(BQueue).to(FanoutExchange); 
} 


(2) 添加 发 送 方法 
完成 队列 和 交换 机 的 配置 后 ， 需 要 在 RabbitmqSender 类 中 添加 如 下 发 送 方法 ， 此 方法 向 
FanoutExchange 交换 机 发 送 消息 。 


public String sendFanout() { 
rabbitTemplete.convertAndSend("FanoutExchange", "all", "fanout send"); 
return "fanout send ok! "; 
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为 了 方便 发 送 的 调用 ， 在 Controller 类 中 添加 发 送 调用 接口 ， 具 体 如 下 : 


@RequestMapping(value="/sendFanout",method=RequestMethod.GET) 
public Result<String> sendFanout() { 

String ret = sender.sendFanout(); 

Result<String> result = new Result<>(ResultCode.OK, ret); 

return result; 


17.5.2 ”接收 方 配置 及 使 用 


接收 方 只 需要 监听 队列 ， 不 关注 队列 的 绑 定 关 系 ， 这 是 和 发 送 方 不 同 的 地 方 。 在 接收 方 首 
先 配置 FanoutExchange 绑 定 的 两 个 队列 AQueue 和 BQueue， 在 Rabbitmq Config 文件 中 添加 如 
下 代码 。 


//fanout 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 炒米 米 米 米 米 米 米 米 米 米 米 米 米 米 
@Bean 
public Queue AQueue() { 

return new Queue("AQueue"); 


} 


@Bean 
public Queue BQueue() { 
return new Queue("BQueue"); 


j 
然后 添加 两 个 队列 的 监听 处 理 类 ， 有 基体 如 下 : 


@Component 
@RabbitListener(queues = "AQueue") 
public class AQueueReceiver { 
@RabbitHandler 
public void process(String message) { 
System.out.println("A QueueReceiver: " + message); 


} 
} 


@Component 

@RabbitListener(queues = "BQueue") 

public class BQueueReceiver { 
@RabbitHandler 
public void process(String message) { 

System.out.println("BQueueReceiver: " + message); 

} 

} 


启动 发 送 方 和 接收 方 服 务 ， 然 后 调用 发 送 方 的 Fanout 模式 接口 ， 可 以 在 接收 方 看 到 如 下 
输出 。 


AQueueReceiver: fanout send 
BQueueReceiver: fanout send 


控制 台 输 出 可 见 ，Fanout 模式 会 向 所 有 绑 定 到 此 交换 机 的 队列 发 送 消 息 。 
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在 一 个 使 用 Spring Cloud 进行 微服 务 化 的 系统 集群 内 ， 包 含 不 同 能 力 的 服务 ， 同 一 服务 还 
包含 多 个 程序 实例 ， 这 些 实例 可 能 运行 在 不 同 的 服务 嚣 中。 如果 集群 中 某 一 服务 出 现 了 问题 需 
要 碍 看 日 志 ， 可 能 要 到 不 同 的 服务 器 中 逐个 查看 日 志文 件 ， 这 明显 是 个 很 麻烦 的 事情 。 使 用 
ELK 就 能 够 很 好 地 解决 此 问题 。 
ELK 是 ElasticSearch、Logstash、Kibana 三 个 软件 的 聚合 ， 使 用 这 三 个 软件 最 后 达到 日 志 
搜集 、 存 储 、 分 析 等 目的 。 其 中 ElasticSearch 提供 存储 及 搜索 引擎 的 能 力 ，Logstash° 是 日 志 
搜集 、 分 析 、 过 滤 、 输 出 的 工具 ; Kiban 为 日 志 分 析 提 供 友好 的 Web 界面 ， 可 以 对 日 志 进 行 
可 视 化 的 搜索 、 汇 总 和 分 析 。 
日 志 搜 集 的 全 流程 大 概 如 图 18-1 所 示 。 大 体 的 思路 就 是 先 把 日 志保 存 到 某 种 介质 ， 然 后 
使 用 工具 把 分 散 的 日 志 搜 集 起 来 ， 对 搜集 到 的 信息 进行 加 工 、 过 滤 然 后 放 入 某 个 存储 介质 ， 最 
后 通过 一 个 可 视 化 的 页 面 进行 分 析 展 示 。 在 实际 业务 中 可 以 对 图 中 的 某 些 模块 进行 修改 ， 例 如 
使 用 Filebeat 或 者 引入 消息 队列 ， 但 是 日 志 搜集 、 存 储 、 展 示 的 思路 不 变 。 


Logback 日 志 输 出 


服务 器 本 地 文件 


Logstash 


图 18-1 日 志 搜集 


由 于 本 书 之 前 已 经 演示 过 ElasticSearch WJ ARIE, MAUDS, KEEA 
Logstash 和 Kibana 的 用 法 。 


18.1 Logstash 使 用 


Logstash 主要 做 的 事情 就 是 获取 数据 、 数 据 加 工 、 输 出 数据 ， 所 以 Logstash 主要 有 
input, filter, output 三 个 角色 ， 这 三 个 角色 对 应 着 Logstash 配置 文件 的 三 段 配置 。Logstash 的 


© 在 日 志 搜集 方面 ， 可 以 在 各 个 服务 器 上 使 用 Filebeat 作为 专门 的 日 志 搜集 工具 ，Filebeat 可 以 把 搜集 到 的 数据 发 送 给 消息 队 
列 用 于 Logstash 读 取 ， 或 者 直接 由 Filebeat 发 送 给 Logstash. 
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安装 可 以 参考 第 19 章 ， 本 节 介 
18.1.1 Logstash 概要 介绍 


可 以 对 Logstash 进行 最 简单 的 配置 ， 例 如 让 Logstash 从 控制 台 读 取信 息 ， 并 且 输 出 到 控 
制 台 ， 配 置 如 下 。 
input { stdin { } } output { stdout { } } 


ANS 


A Logstash 的 配置 和 效果 展示 。 


当 使 用 此 配置 执行 的 Logstash 向 控制 台 输入 一 串 信 息 后 ，Logstash 会 进行 搜集 和 输出 。 例 
如 向 控制 台 输 入 : javadevmap， 可 以 得 到 如 下 输出 。 

{ 
"@version" => "1", 
"host" => "c819060a5310", 
"@timestamp" => 2018-05-28T09:38:43.139Z, 
"message" => "javadevmap" 

} 


以 上 就 完成 了 Logstash 最 简单 的 搜集 和 输出 能 力 。 对 于 Logstash KE, input 和 output 是 
必要 的 ，filter 是 非 必要 的 ， 但 是 filter 的 数据 处 理 能 力 能 够 完成 很 多 事情 ， 例 如 对 非 规范 数据 
进行 处 理 或 者 对 某 些 特殊 字段 进行 处 理 。Logstash 三 个 模块 主要 能 力 如 下 : 
E input: 从 数据 源 获 取 数 据 ， 数 据 源 包含 File 文件 、syslog 系统 日 志 、redis、beats 
(Filebeats ) 。 

E filter: 负责 处 理 数据 与 转换 ， 包 含 grok 正则 匹配 能 力 、mutate 事件 转换 、drop 事件 于 
弃 、clone 事件 复制 、geoip 处 理 IP 等 。 

加 output: 输出 到 目标 介质 ， 包 含 elasticsearch、file、statsd 等 。 


18.1.2 ”文件 搜集 及 ElasticSearch 存储 
Logstash 可 以 使 用 插件 的 形式 配置 它 的 输入 和 输出 ， 并 且 可 以 在 同一 模块 中 配置 多 个 插件 


实现 多 输入 源 或 多 输出 的 目的 。 由 于 之 前 的 代码 中 ， 大 部 分 日 志 都 已 经 打印 至 文件 ， 所 以 这 里 
主要 介绍 文件 形式 的 日 志 搜 集 ， 输 出 的 目的 地 为 ElasticSearch。 
对 Logstash 进行 如 下 配置 。 
input { 
file { 
path => "/logs/*/*" 
start_position => "beginning" 


Lin! 


} 
} 
output { 
elasticsearch { 
hosts => ["172.17.238.238:9200"] 
index => "logstash-% {+Y Y Y Y.MM.dd}" 
} 
} 


在 此 配置 中 ， 设 置 input 的 输入 方式 是 文件 读 取 ， 使 用 file 插件 ， 在 插件 中 使 用 path 参数 
设置 文件 读 取 的 目录 ， 这 里 使 用 正则 的 方式 匹配 符合 规则 的 文件 地 址 ，start_position 设置 了 文 


第 18 章 


和 index 的 命名 方式 。 
登录 ElasticSearch， 可 以 查看 日 志 搜 集 后 的 信息 ， 这 里 截取 其 中 一 条 。 
{ 


" index": "logstash-2018.05.29", 
"type": "logs", 
"id": "AWOpxzCn2OudMV XehqwQ", 
" version": 1, 
score": 1, 
source": 
"@version": "1", 
"host": "serverA", 
"path": "/logs/SpringCloudEureka/2018-05-29.0.log", 
"@timestamp": "2018-05-29T02:43:13.523Z", 


"message": "2018-05-29 10:42:09.577+0800 INFO o.s.b.c.e.t. TomcatEmbeddedServlet 


Container [SpringCloudEureka, , , ], [ main] : Tomcat initialized with port(s): 18001 (http)" 
j 
} 


18.1.3 ”使 用 Json 格式 日 志 


ELK 


件 开始 读 取 的 位 置 ，beginning 表示 从 文件 头 读 取 。 在 output P, wA J ElasticSearch 的 地 址 


从 上 一 节 的 输出 可 以 看 到 ， 在 程序 中 使 用 Logback 打印 的 数据 ， 仅 仅 是 Logstash 数据 内 


了 ， 所 以 需要 对 log 内 容 进 行 处 理 。 


ir) 


容 中 的 message 字段 的 内 容 ， 这 个 message 内 容 是 按照 日 志 在 Logback 中 设置 的 打印 格式 进行 
输出 的 ， 如 果 使 用 Kibana 进行 内 容 检索 或 者 进行 日 志 分 析 ， 这 种 格式 就 很 难 进行 分 析 和 制图 


处 理 这 种 内 容 可 以 使 用 grok 插件 进行 正则 匹配 ，grok 会 根据 设置 的 规则 在 message 信息 


输出 Json 格式 ， 这 样 就 不 需要 正则 匹配 的 处 理 ， 也 节省 了 Logstash 的 计算 过 程 。 
(1) Logback 设置 Json 格式 打印 


在 工程 的 pom 文件 中 添加 如 下 依赖 


<dependency> 
<groupId>net.logstash.logback</groupId> 
<artifactld>logstash-logback—encoder</artifactld> 
<version>5.0</version> 

</dependency> 


LogstashEncoder 方式 。 


<appender name="FILE" class="ch.qos.logback.core.rolling.RollingFileAppender"> 
/其 他 内 容 不 变 .… 
<encoder charset="UTF-8" class="net.logstash.logback.encoder. LogstashEncoder"> 
<customFields> {"servicename":"${APP_Name}"}</customFields> 
</encoder> 
</appender> 


(2) Logstash 接收 Json 数据 
修改 Logstash 的 配置 ， 在 input 中 使 用 codec 参数 设置 接收 的 内 容 为 Json 格式 。 


= 


中 截取 符合 规则 的 字段 ， 这 样 就 能 实现 数据 内 容 的 处 理 。 还 有 一 种 方法 是 在 打印 日 志 时 ， 直 接 


在 logback-spring.xml 的 日 志 设 置 文件 中 ， 修 改 输出 到 文件 的 编码 方式 ， 改 为 使 用 


363 


Java 服务 端 研 发 知识 图 谱 


input { 


} 
(3) 输 昌 


file { 


path => "/logs/*/*" 
codec => "json" 
start_position => "beginning" 


展示 
启动 Logstash 搜集 新 打印 的 日 志 后 ， 可 以 在 ElasticSearch 中 看 到 如 下 数据 内 容 ，Logback 


打印 的 Json 数据 可 以 在 Logstash 中 识别 。 


{ 


" index": "logstash-2018.05.29", 
"type": "logs", 
" id": "AWOp0q-120udMVXehrHm", 
"version": 1, 
score": 1, 
source": 
"path": "/logs/SpringCloudEureka/2018-05-29.0.log", 
"@timestamp": "2018-05-29T02:54:44.206Z", 
"level": "INFO", 
"thread_name": "main", 
"level_value": 20000, 
"@version": "1", 
"host": "serverA", 
"servicename": "SpringCloudEureka", 


"logger name": "org.apache.catalina.core.StandardEngine", 
"message": "Starting Servlet Engine: Apache Tomcat/8.5.29" 


" 


" 


18.1.4 使 用 filter 处 理 数据 


在 实际 业务 中 ， 可 能 期 望 根据 用 户 的 年 龄 和 地 域 进 行 统计 分 析 ， 这 种 情况 下 使 有 


H filter 处 理 


用 户 当前 IP 然后 解析 出 具体 的 地 址 是 一 个 不 错 的 选择 。 例 如 在 代码 中 ， 使 用 log.info0 方 法 打印 


一 个 Json 格式 的 日 志 {f"userIp":"47.95.113.117","age":30}， 日 志 的 总 体 ] 


{ 


} 


在 Logstash 本 
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"@timestamp": "2018-05-29T 15:57:54.812+08:00", 

"@version": "1", 

"message": " {\"userIp\":\"47.95.113.117\"",\"age\":30}", 

"logger name": "com.javadevmap.serviceprovider.controllers. UserController", 
"thread_name": "hystrix—provider-usercontroller-2", 

"level": "INFO", 

"level_value": 20000, 

"X-Span- Export": "true", 

"X-B3-SpanId": "3c7551c6dc8a5d5b", 

"X-B3~Traceld": "3c7551c6dc8a5d5b", 


"servicename": "SpringCloudServiceProvider" 


打印 内 容 如 下 : 


C 置 文件 中 添加 如 下 配置 ， 就 可 以 实现 对 log.info0) 方 法 中 打印 数据 的 Json 解 


析 ， 并 且 可 以 根据 IP 识别 地 址 。 


/省略 input... 
filter { 
json { 


source => "message" 


} 

geoip { 

source => "userIp" 
} 

} 

// 省 上 略 output... 
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通过 Logstash 识别 后 ， 除 了 正确 地 解析 了 message 信息 ， 还 在 生成 的 数据 中 添加 了 geoip 
数据 段 ， 在 此 数据 段 下 包含 一 系列 地 理 位 置 的 内 容 。 


18.2 Kibana 使 用 


Kibana 是 一 个 日 志 聚 合 


展示 的 可 视 化 Web 工具 ， 可 以 在 Kibana 中 查看 单条 日 志 的 情况 ， 


可 以 根据 特定 条 件 聚 合 某 类 日 志 信息 ， 从 而 实现 饼 图 等 可 视 化 视图 的 分 析 展 示 。Kibana 的 安 


装 请 参看 第 19 章 ， 本 节 介 绍 Kibana 的 几 利 


(1) 基本 配置 


Status: Red A 


Installed Plugin 


Name 
kibana 
elasticsearch 
kbn_vislib_vis_types 
markdown_vis 
metric_vis 
spyModes 
statusPage 


table_vis 


基本 使 用 方法 。 


使 用 Docker 安装 Kibana 需要 注意 ElasticSearch 的 地 址 ， 如 果 使 用 了 错误 的 地 址 会 出 现 如 
18-2 所 示 的 错误 提示 信息 。 


Version Status 

1.0.0 Ready 

1.0.0 A Unable to connect to Elasticsearch at http://127.0.0.1:9200 
1.0.0 Ready 

1.0.0 Ready 

1.0.0 Ready 

1.0.0 Ready 

1.0.0 Ready 

1.0.0 Ready 


索 的 index， 本 节 使 用 正则 
(2) 简单 搜索 


词 高 亮 显示 ， 如 图 18-4 所 示 。 


图 18-2 Kibana 配置 错误 提示 


正确 配置 ElasticSearch 地 址 ， 并 且 进 入 Kibana 之 后 ， 可 以 在 “Settings ”选项 中 选择 要 检 
匹配 “1logstasp-*”， 如 网 18-3 所 示 。 


在 Kibana 中 ， 进 入 “Discover” 页 签 ， 可 以 在 输入 框 输入 简单 的 查询 条 件 ， 并 且 在 右上 和 角 
配置 正确 的 时 间 维 度 ，Kibana 会 根据 查询 条 从 


F 进 行 搜索 ， 并 且 在 搜索 到 的 内 容 中 对 搜索 关键 
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Index Patterns 


$ logstash-* 


Indices Advanced 


| @ ana Discover Visualize Dashboard Settings 


Objects Status About 


Configure an index pattern 


In order to use Kibana you must configure at least one index pattern. Index patterns are used to identify the Elasticsearch index to run 
search and analytics against. They are also used to configure fields. 


# Index contains time-based events 


Use event times to create index names [DEPRECATED] 


Index name or pattern 


Patterns allow you to define dynamic index ni 


sing * as a wildcard. Example: logstash-* 


logstash-* 


Do not expand index pattern when searching (Not recommended) 


hes against any time-based index pattern that contains a wildcard will automatically be expanded to query only the 
ime range 


I actually query e! arch for the sp 


natching indices (e.g. | 


Time-field name @ refresh fields 


@timestamp X 


ipana 


logstash-* 


Selected Fields 


Available Fields g 
@timestamp 
@version 
X-B3-Spanld 
X-B3-Traceld 
X-Span-Export 
_id 
_index 
_score 
type 
age 
clientip 
geoip.city_name 
geoip.continent_code 
geoip.country_code2 
geoip.country_code3 


geoip.country_name 


(3) 制作 简单 的 饼 图 


如 果 想 查看 某 种 数据 的 分 布 比例 情况 ， 可 以 # 
况 ， 可 以 选择 “Visualize->Pie chart->From a new search”， 然 后 配置 检索 的 数据 项 和 展示 的 个 


Count 


» 


Discover 


Time 


May 29th 2018, 15:52:41.647 


May 29th 2018, 16:07:35.073 


i) 


图 18-3 Kibana 起 始 页 
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_source 


message: {"userIp":"47.95.113.117","age":30} userIp: 47.95.113.117 X-Span-Export: true geoip.city neme: Hangzhou 
geoip. timezone: Asia/Shanghai geoip. ip: 47.95.113.117 geoip.latitude: 30.294 geoip. country nane: China 
geoip. country code2: CN geoip. continent code: AS geoip.country_code3: CN geoip.region name: Zhejiang geoip location: { 


“Jon”: 120.1614, “lat”: 30.2936 } geoip.region code: 33 geoip. longitude: 120.161 level: INFO path: /logs/SpringCl 


userIp":"47.95.113,117 


message 


“age":16} userIp: 47.95.113.117 X-Span Export: true geoip.city_nene: Hangzhou 
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"lon": 120.1614, "lat": 30.2936 } geoip.region_code: 33 geoip. longitude: 120.161 level: INFO path: /logs/SpringCl 


图 18-4 Kibana 搜索 


D) 


数 ， 点 击 执行 按钮 后 就 可 以 看 到 统计 情况 ， 如 图 18-5 所 示 。 


(4) 双 层 饼 图 


可 以 在 饼 图 的 基础 上 ， 选 择 子 分 析 项 ， 从 而 形成 双 层 的 饼 
再 次 输入 一 个 分 析 和 条件， 可 以 看 到 效果 如 图 18-6 所 示 。 
页 面 的 右上 方 有 一 个 保存 按钮 ， 点 击 此 按钮 ， 输 入 信息 并 保 


“add sub-buckets”, 


HDR EA A 


存 即 可 。 
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器 作 一 个 饼 图 。 例 如 查看 用 户 的 年 龄 分 布 情 


图 。 在 图 18-5 WA RA, md 
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(5) 地 图 分 布 

Kibana 可 以 根据 地 理 位 置 绘制 一 个 用 户 的 位 置 分 布 图 。 选 择 “Visualize->Tile map->From 
anew search”， 然 后 在 配置 项 中 选择 Geohash 和 geoip.location， 可 见 如 图 18-7 所 示 的 用 户 分 布 
情况 ， 此 地 图 可 以 放大 、 缩 小 。 

《6) 聚合 展示 

Kibana 可 以 把 之 前 保存 的 分 析 图 聚合 展示 出 来 ， 选 择 “Dashboard”， 然 后 根据 页 面 的 提示 
添加 之 前 保存 的 分 析 图 ， 可 以 看 到 如 图 18-8 ARRARIR KH o 
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第 四 篇 部 署 fa 


对 于 一 名 研发 人 员 来 讲 ， 前 面 的 章节 基本 已 经 覆盖 了 日 常 工作 的 大 部 分 内 容 ， 但 是 软件 研 
发 这 个 职业 就 是 需要 不 断 探索 的 ， 所 以 本 篇 将 主要 介绍 Docker 和 Jenkins 的 使 用 以 及 服务 集群 
的 管理 ， 让 研发 者 能 够 从 服务 运行 的 角度 了 解 自 己 的 程序 。 

Docker 是 目前 非常 流行 的 镜像 技术 ， 可 以 通过 Docker 运行 任何 一 个 组 件 ， 包 括 自己 编写 
的 程序 。Docker 的 特性 会 保证 平台 间 的 兼容 性 以 及 快速 部 署 的 能 力 。 上 一 篇 中 使 用 的 系统 组 
件 ， 有 些 安装 和 配置 较为 烦琐 ， 但 是 如 果 仅 是 研发 人 员 在 功能 环境 中 进行 简单 的 使 用 ， 就 没有 
必要 麻烦 运 维 人 员 了 ， 使 用 Docker 就 可 以 非常 简单 地 安装 系统 组 件 。 在 第 19 章 ， 将 介绍 
Docker 的 基本 用 法 、 命 令 以 及 组 件 的 安装 。 

在 研发 或 者 生产 环境 上 线 过 程 中 ， 尤 其 是 服务 联 调 阶 段 ， 把 程序 部 署 到 相应 环境 是 一 个 非 
常 频繁 的 工作 ， 而 对 于 一 个 服务 集群 来 讲 ， 如 果 全 部 手动 部 署 ， 工 作 量 将 会 非常 大 的 。 使 用 
Jenkins 可 以 方便 快捷 地 完成 自动 化 编译 和 部 署 ， 在 第 20 章 ， 将 会 介绍 Jenkins 的 基本 使 用 。 

如 果 想 让 集群 内 的 程序 具备 Docker 的 特性 ， 那 么 就 要 把 程序 生成 为 一 个 镜像 ， 这 就 会 面 
临 镜像 存储 和 镜像 运行 后 容器 管理 的 问题 。 在 第 20 章 将 会 介绍 镜像 仓库 Harbor 以 及 容器 管理 
工具 Rancher 的 使 用 。 

希望 通过 本 篇 的 学 习 ， 读 者 能 够 从 集群 运行 的 角度 考虑 大 集群 的 管理 和 自动 化 的 使 用 。 


“197% Docker 


当 把 程序 部 署 到 服务 器 时 ， 常 常 面临 环境 的 问题 ， 例 如 系统 版 本 和 程序 不 匹配 、 使 用 的 
JDK 版 本 需要 重新 安装 、 系 统 的 环境 变量 需要 重新 设置 、 新 程序 与 服务 器 中 已 存在 程序 之 间 的 
冲突 等 问题 。 这 些 问 题 给 服务 集群 的 部 署 带 来 了 一 定 的 麻烦 ， 每 次 上 线 可 能 由 于 几 个 环境 问题 
要 调试 好 久 。 解 决 以 上 问题 就 是 Docker 应 用 的 场景 。 
Docker 是 怎么 解决 这 些 问 题 的 ? 其 实 看 一 张 Docker mr 
的 图 片 可 能 更 容易 理解 。 如 图 19-1 所 示 ， 图 片 中 的 鲸 可 HUTT TTT Ss 
以 想象 为 服务 器 ， 图 片 中 的 集装箱 可 以 想象 为 一 个 一 个 的 
程序 ，Docker 的 核心 理念 就 是 把 程序 的 所 有 准备 工作 都 放 = 
到 集装箱 中 ， 当 需要 某 个 程序 在 某 台 服务 器 运行 时 ， 只 要 
把 这 个 集装箱 放 到 服务 器 上 就 可 以 正常 运行 了 。 
基于 以 上 的 出 发 点 ，Docker 包含 的 主要 特性 如 下 : OC PA ( 
Mm 更 高 效 的 虚拟 化 ，Docker 对 程序 进行 隔离 的 虚拟 图 19-1 Docker 图 标 
化 技术 占用 资源 极 少 ， 虚 拟 化 部 分 不 会 占用 过 多 的 
系统 开销 。 
BS 更 快 的 部 署 ， 只 要 服务 器 具备 Docker 容器 运行 的 基础 条 件 ， 就 可 以 把 Docker 容器 部 
署 到 此 服务 器 中 ， 而 不 用 考虑 其 他 环境 因素 。 
m 简单 的 镜像 生成 ， 通 过 Dockerfile 可 以 方便 地 生成 Docker 镜像 ， 这 个 镜像 会 把 程序 以 
及 程序 运行 的 基础 环境 统一 打包 。 
图 方便 移植 ，Docker 的 兼容 性 可 以 保证 在 任何 平台 上 运行 的 Docker 容器 能 够 快速 地 在 其 
他 平台 的 Docker 环境 下 使 用 。 
m 可 以 使 用 Docker 相关 的 管理 工具 ， 对 程序 的 历史 镜像 版 本 、 容 器 的 启动 及 当前 状态 进 
行 监控 和 管理 。 


19.1 Docker 基础 环境 搭建 


TE 


要 想 在 某 台 服务 器 中 运行 Docker 容器 ， 就 必须 为 容器 准备 基础 的 Docker 环境 。 本 节 使 用 
yum fir ZIMEN Docker 环境 ， 并 且 为 提高 镜像 的 下 载 速度 配置 加 速 器 。 
19.1.1 Docker 环境 安装 


本 节 介 绍 CentOS 7.3 版 本 64 位 系统 中 Docker 环境 的 安装 。 
图 安装 命令 

$ yum install docker 
E 查看 服务 状态 


$ service docker status 
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图 启动 服务 


$ service docker start 
E 查看 服务 版 本 
$ docker version 
m 查看 docker 信息 


$ docker info 


19.1.2 Docker 环境 印 载 
WI RARER Docker 环境 ， 只 要 顺序 执行 如 下 命令 即 可 完成 。 
E 查看 安装 的 Docker 组 件 

$ yum list installed | grep docker 

加 逐个 删除 Docker 组 件 

$ yum - y remove [name] 

图 删除 Docker 遗留 文件 
$ rm -rf /var/lib/docker 


19.1.3 ”镜像 加 速 


在 使 用 Docker 下 载 镜像 并 且 运 行 容 器 之 前 ， 还 有 一 项 配置 是 必 不 可 少 的 ， 即 为 Docker 的 
镜像 下 载 配置 加 速 器 。 这 里 使 用 DaoCloud 的 加 速 器 配置 方法 ， 在 服务 器 执行 如 下 命令 : 


$ curl -SSL https://get.daocloud.io/daotools/set_mirror.sh | sh -s http://5b55f8e6.m.daocloud.io 
执行 命令 后 ， 会 得 到 如 下 输出 。 

$ docker version >= 1.12 

{"registry—mirrors": ["http://5b55f8e6.m.daocloud.io"],} 


Success. 
You need to restart docker to take effect: sudo systemctl restart docker 


上 面 生 成 的 地 址 中 ， 末 尾 多 了 一 个 逗号 ， 所 以 需要 修改 /etcldocker 目 录 下 的 daemon.json 
文件 ， 改 为 
{"registry—mirrors": ["http://5b55f8e6.m.daocloud.io"]} 
然后 执行 如 下 命令 ， 重 启 服 务 。 
$ systemctl daemon-reload 
$ systemctl restart docker 


w] 


19.2 Docker 常用 命令 


在 服务 器 中 准备 好 了 Docker 环境 ， 就 可 以 通过 Docker 的 命令 获取 镜像 ， 并 且 运 行 容器 
J. Docker 命令 主要 是 针对 镜像 和 容器 的 操作 ， 例 如 拉 取 镜像 、 创 建 镜像 、 运 行 容 器 。 如 果 
第 一 次 接触 镜像 和 容器 可 能 会 比较 难以 理解 ， 简 单 来 讲 可 以 把 镜像 理解 为 程序 的 安装 包 ， 镜 
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像 运 行 后 就 成 为 了 容器 ， 所 以 可 以 把 容器 理解 为 程序 运行 的 进程 。 下 面 介绍 Docker 的 常用 


人 
命令 。 


19.2.1 ”针对 镜像 的 命令 
(1) 搜索 镜像 


$ docker search [OPTIONS] NAME 
使 用 如 上 命令 ， 可 以 针对 某 个 镜像 的 名 字 进 行 搜索 。OPTIONS 是 可 选项 ， 指 定 搜索 的 条 
件 ， 例 如 docker search -s 10 redis 的 se 10 的 Redis 的 镜像 。 
(2) 拉 取 镜像 
$ docker pull [OPTIONS] NAME 
使 用 此 命令 可 以 拉 取 镜像 ， 其 中 NAME 中 可 以 指定 具体 的 tag 标签 ， 即 可 拉 取 相应 tag 的 
镜像 ， 如 果 不 指定 此 标签 则 拉 取 最 新 的 镜像 。 
(3) 显示 当前 镜像 列表 
$ docker images [OPTIONS] 
命令 用 于 显示 镜像 列表 ， 如 果 设 置 [OPTIONS] 可 以 指定 条 件 或 者 显示 方式 。 
删除 镜像 
$ docker rmi [OPTIONS] image 
例如 删除 镜像 Redis， 可 以 使 用 docker rmi docker.io/redis 命令 。 
(5) 给 镜像 打 标 签 
$ docker tag NAME NAME/version 
此 命令 在 自 定 义 镜 像 的 版 本 管理 时 非常 有 用 。 
(6) 登录 镜像 仓库 
$ docker login[OPTIONS] [SERVER] 
此 命令 可 以 通过 Server 指定 具体 的 仓库 地 址 ， 在 后 面 演 示 集 群 部 署 时 登录 自 定 义 仓 库 会 
用 到 。 
(7) 登 出 镜像 仓库 
$ docker logout[OPTIONS] [SERVER] 
(8) 推送 镜像 至 仓库 
$ docker push NAME 
(9) 将 镜像 保存 成 归档 文件 
$ docker save —o FILE IMAGE 
例如 使 用 docker save -o redis.tar docker.io/redis 把 镜像 保存 为 文件 。 
(10) 从 归档 文件 中 创建 镜像 
$ docker import FILE IMAGE 
例如 使 用 docker import redis.tar javadevmap/redis 导入 镜像 后 ， 可 以 查看 镜像 列表 中 多 出 一 
个 镜像 。 


TT 
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(11) 使 用 Dockerfile 创建 镜像 
$ docker build [OPTIONS] IMAGE PATH 


19.2.2 ”针对 容器 的 命令 
(1) 运行 容器 
$ docker run [OPTIONS] IMAGE 
以 运行 redis 容器 为 例 ， 可 以 使 用 如 下 命令 。 
$ docker run -name jdm redis -p 6379:6379 -d docker.io/redis 


第 19 Docker 


此 命令 运行 了 一 个 Redis 容器 ， 并 且 指 定 容器 名 字 为 jdm _ redis， 服 务 器 与 容器 的 端口 映射 
为 6379:6379， 并 且 指 定 容 器 在 后 台 运 行 。 运 行 容 器 时 可 以 指定 的 参数 较 多 ， 这 些 参数 直接 指 


定 容 器 的 属性 ， 所 以 比较 重要 ， 见 表 19-1。 


表 19-1 Docker 运行 参数 


=d 后 台 运 行 容器 ， 并 返回 容器 ID 
一 name 肯定 容器 名 称 
P 指定 容器 端口 映射 
一 net 指定 容器 网 络 类 型 ， 共 有 bridge、host、none、container 四 种 类 型 
h 指定 容器 的 主机 名 
v BE AA ERB, PDA EDLY HK 
ve ae AA A a EE 
m 指定 容器 的 内 存 上 限 ， 格 式 是 数字 加 单位 ， 单 位 可 以 为 b,k,m,g 


(2) 查看 运行 中 的 容器 
$ docker ps [OPTIONS] 


不 包含 参数 则 查看 当前 运行 容器 ， 如 果 指 定 [OPTIONS] 为 -a， 则 查 


关闭 的 )。 
(3) 停止 容器 
$ docker stop CONTAINER 
(4) 启动 被 停止 的 容器 
$ docker start CONTAINER 
(5) 重启 容器 
$ docker restart CONTAINER 
(6) 强制 杀 掉 容器 
$ docker kill CONTAINER 


(7) 删除 容器 
$ docker rm [OPTIONS] CONTAINER 


看 所 有 


Aas (HOA 
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[OPTIONS] 使 用 -~v 参数 可 以 删除 容器 挂 载 的 数据 卷 。 
(8) 创建 容器 但 不 启动 


$ docker create[OPTIONS] IMAGE 


(9) 查看 容器 日 志 


$ docker logs[OPTIONS] CONTAINER 


(10) 进入 运行 的 容器 执行 命令 


$ docker exec [OPTIONS] CONTAINER 


例如 进入 刚刚 运行 的 redis 容器 ， 设 置 redis 的 密码 ， 可 以 使 用 如 下 命令 。 


(11) 获取 容器 /镜像 的 元 数据 


$ docker exec -it CONTAINERID /bin/bash 
$ redis-cli 

$ config set requirepass mypass 

$ exit 

$ exit 


$ docker inspect IMAGE/CONTAINER 


(12) 查看 容器 运行 的 进程 信息 


$ docker top CONTAINER 


(13) 由 容器 创建 镜像 


C14) 主机 和 容器 间 的 数据 复制 


$ docker commit [OPTIONS] CONTAINER IMAGE 


$ docker cp [OPTIONS] SRC DEST 


例如 向 redis 容器 中 复制 数据 ， 可 以 使 用 如 下 命令 。 


$ docker cp /logs CONTAINERID:/logs 


19.2.3 ”使 用 Dockerfile 创建 镜像 


把 自己 编写 的 Java 服务 运行 在 Docker 上 的 前 提 是 生成 一 个 服务 的 镜像 ， 可 以 使 用 
Dockerfile 文件 配置 镜像 内 容 ， 然 后 就 可 以 通过 docker build 命令 生成 镜像 了 。 下 面 以 之 前 编写 


的 工程 SpringCloudServiceProvider 为 例 ， 生 成 此 服务 的 镜像 ， 并 且 了 解 Dockerfile 文件 的 属性 


含义 。 


C1) 生成 服务 jar 包 
首先 编 i 对 工程 ， 可 


件 之 前 4 


at 


以 得 到 SpringCloudServiceProvider-0.0.I-SNAPSHOT, jar 文件 ， 这 个 文 


介绍 过 ， 可 以 通过 java-jar 的 方式 直接 启动， 镜像 文件 也 需要 此 文件 才能 


(2) 编写 Dockerfile 文件 


Dockerfile 文件 其 实 可 以 理解 为 一 个 配置 文件 ， 它 描述 了 一 个 镜像 包含 的 内 


自动 服务 。 


容 和 需要 启 


动 的 方法 等 ， 本 例 先 创建 Provider 服务 的 Dockerfile 文件 ， 后 面 会 详细 讲解 文件 中 字段 的 


含义 。 
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ADD SpringCloudServiceProvider-0.0.1-SNAPSHOT.jar /data/run/ 

EXPOSE 18010 

WORKDIR /data/run/ 

ENTRYPOINT ["java","-jar","SpringCloudServiceProvider—0.0.1-SNAPSHOT jar","——spring. profiles. 


> 


active =providerA"] 
上 面 的 代码 中 ， 用 到 了 部 分 Dockerfile 的 属性 。FROM 指定 了 基础 的 镜像 ， ADD 把 jar X 
件 放 入 镜像 的 /data/run Hox; EXPOSE 指定 镜像 对 外 暴露 18010 端口 ，WORKDIR 指定 镜像 内 
的 工作 目录 为 /data/run; ENTRYPOINT 配置 了 镜像 的 启动 运行 命令 。 
(3) 生成 镜像 
把 上 面 的 jar 包 和 Dockerfile 文件 放 入 同一 目录 下 ， 然 后 运行 如 下 命令 ， 注 意 命令 中 结尾 
有 “.” 符 号 表示 当前 路 径 。 
$ docker build -t springcloud/provider:0.0.1 . 
运行 命令 后 ， 可 以 看 到 显示 如 下 内 容 。 
Sending build context to Docker daemon 57.34 MB 
Step 1 : FROM java:8 
一 -> d23bdf5b1b1b 
Step 2 : ADD SpringCloudServiceProvider-0.0.1-SNAPSHOT.jar /data/run/ 
一 -> e42cfd8b2d40 
Removing intermediate container c60ab61ba06f 
Step 3 : EXPOSE 18010 
——-> Running in cda6abeS5 féal 
一 -> fbead3671920 
Removing intermediate container cda6abeSf6al 
Step 4 : WORKDIR /data/run/ 
——-> Running in de9bdb55164a 
一 -> 66f3e557c0b8 


Removing intermediate container dc9bdb55 164a 
Step 5 : ENTRYPOINT java -jar SpringCloudServiceProvider-0.0.1-SNAPSHOT jar —spring. profiles. 


active=providerA 
——-> Running in be49fd1 b8fe4 
——-> e6ad17c121be 
Removing intermediate container be49fd1b8fe4 
Successfully built e6ad17c121be 
(4) 运行 镜像 并 查看 服务 情况 
现在 镜像 已 经 生成 ， 可 以 通过 docker images 命令 查看 镜像 ， 会 得 到 如 下 输 昌 
REPOSITORY TAG IMAGE ID CREATED SIZE 
springcloud/provider 0.0.1 e6adl7cl21lbc 2 minutes ago 700.3 MB 
这 就 是 刚刚 生成 的 镜像 ， 可 以 使 用 docker run 命令 启动 镜像 。 
$ docker run -d ——-name provider --net=host ~v /logs:/logs e6ad17c121be 
上 面 的 命令 指定 容器 在 后 台 运 行 ， 和 主机 共享 网 络 ， 把 镜像 内 的 Mogs 目录 进行 挂 载 ， 容 
器 名 为 provider。 运 行 命令 后 ， 可 以 通过 docker ps 命令 查看 容器 情况 ， 如 图 19-2 所 示 


CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES 
ed076372flel e6ad17c121bc "java -jar Springclou" 7 seconds ago up 6 seconds provider 


Co 
o 


图 19-2 容器 运行 情况 
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(5) 容器 


查看 Eureka 服务 注册 信息 ， 可 以 看 到 


yo Ze 


运行 情况 
通过 Postman 请 求 此 容器 服务 ， 可 以 看 到 如 图 


19-3 所 示 的 请 求 结果 。 


À 


7.93.199.101:18010/user. 


GET http://4 
Headers 
Key Value 
Body 
Pretty = 
“name": “svn”, 
“phoneNum": "12345678901" 
u } 
图 19-3 请求 容器 中 的 服务 


新 的 容器 服务 已 经 注册 进来 ， 如 图 


— 


Instances currently registered with Eureka 


19-4 所 示 。 


Application AMIs Availability Zones Status 

CONFIG-SERVER n/a (1) (1) UP (1) 

EUREKA-SERVER n/a (2) (2) UP (2) 

SERVICE-CONSUMER n/a (1) (1) UP (1) - 172.17.238.237:1802 
SERVICE-PROVIDER n/a (3) (3) 2.17.238 
TURBINE n/a (1) (1) UP (1) - 172.17.238.237:18030 
ZIPKIN-SERVER n/a (1) (1) UP (1) 

ZUUL n/a (1) (1) UP (1) 

图 19-4 容器 服务 注册 至 Eureka 


(6) 常用 指令 
上 面 使 用 Dockerfile 的 方式 创建 了 镜像 ， 在 文件 中 使 用 了 部 分 Dockerfile 的 指令 设置 镜像 


的 内 容 和 执行 方法 。 


介绍 Dockerfile 的 常用 指令 ， 见 表 19-2. 


下 面 简单 


表 19-2 Dockerfile 指令 


指 令 Ke R 作用 与 用 法 
ERON FROM <image>; FROM 指令 必须 是 Dockerfile 的 第 一 条 指令 ， 使 用 此 指令 指 
FROM <image>:<tag> 定 基础 镜像 ，FROM 指令 之 后 的 其 他 指令 都 依赖 于 此 镜像 
ADD ADD <sre><dest> 于 复制 指定 的 文件 或 URL 至 容器 的 目标 地 址 
COPY COPY<sre><dest> 本 地 文件 向 容器 目标 地 址 复制 
声明 容器 运行 时 提供 的 端口 ， 可 声名 多 个 端口 ; 运行 容器 
EXPOSE EXPOSE <port> [<port>... cae faa a 
pore bere 时 可 以 使 用 “-p port:port” 的 方式 映射 主机 和 容器 中 
4 ge 、 b Afb a 人 
WORKDIR WORKDIR /path i 为 后 续 的 RUN, CMD, ENTRYPOINT 指令 指定 容器 内 的 


工作 目录 
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( 续 ) 
it 令 格 R 作用 与 用 法 
ENTRYPOINT ["executable", "param1", sy Sas ee 和 入 人 pjata 4 pS 
aX sFH S D 多 a, 日 只 
ENTRYPOINT "param2"]; Po 甩 动 时 的 执行 命令 ， 可 以 设置 多 个 ， 但 只 有 最 后 
ENTRYPOINT command paraml param2 VER 
RUN RUN <command>; RUN <command> 在 shell 终端 运行 ， 即 /bin/sh -c; 后 者 使 用 
RUN ["executable", "param1", "param2"] exec 执行 ， 例 如 RUN ["/bin/bash", "-c", "echo hello"] 
CMD ["executable","param1","param2"]; 启动 容器 时 执行 的 命令 ， 每 个 Dockerfile 只 能 有 一 条 CMD 
CMD CMD ["param1","param2"]; AA 
CMD command param! param2 ve 
ENV ENV <key><value> 设置 环境 变量 
VOLUME VOLUME ["/data"] 指定 挂 载 点 
MAINTAINER | MAINTAINER<name> 指定 维护 者 信息 
LABEL LABEL<key>=<value> 为 镜像 指定 元 数据 


19.3 Docker 搭建 功能 组 件 


前 面 章节 使 用 了 大 量 的 功能 组 件 ， 对 于 研发 人 员 来 讲 ， 搭 建 这 些 组 件 可 能 是 一 件 非常 麻烦 

和 费时 的 事情 ， 因 为 各 种 依赖 和 环境 经 常 要 配置 好 久 ， 可 能 还 会 出 错 。 大 部 分 情况 下 研发 人 员 

想 搭建 一 套 功 能 环境 都 会 求助 于 运 维 人 员 ， 现 在 有 了 Docker 就 可 以 让 一 切 简单 很 多 ， 通 过 

Docker 运行 一 个 容器 就 可 以 启动 一 个 功能 组 件 。 下 面 介绍 使 用 Docker 简单 搭建 组 件 的 方法 ， 虽 

然 使 用 如 下 方法 无 法 搭建 真正 高 可 用 的 功能 组 件 ， 但 是 研发 人 员 在 功能 环境 使 用 已 经 足够 了 。 
(1) 搭建 MySQL 

$ docker pull docker.io/mysql:5.6.35 


$ docker run —-name jdmmysq! -p 3306:3306 -e MYSQL_ROOT_PASSWORD=mypass ~v /etc/ 
localtime: /etc/localtime -d docker.io/mysql:5.6.35 


使 用 如 上 命令 ， 可 以 完成 MySQL 的 搭建 ， 容 器 时 间 使 用 的 是 系统 时 间 ， 使 用 SQLyon 连 
接 数 据 库 时 的 密码 是 mypass。 
(2) 搭建 MongoDB 


$ docker pull docker.io/mongo 

$ docker run --name jdmmongo -p 27017:27017 -d docker.io/mongo ——auth 
$ docker exec -it jdmmongo /bin/bash 

$ mongo 

$ use admin 

$ db.createUser({user:"root",pwd:"mypass",roles:[ {role:'root',db:'admin'}]}) 
$ exit 

$ exit 


配置 完成 后 ， 可 以 使 用 Robomongo 或 NoSQL Manager for MongoDB 工 
账号 root， 密 码 mypass. 
(3) 搭建 Redis 
$ docker pull docker.io/redis 


$ docker run --name jdmredis -p 6379:6379 -d docker.io/redis 
$ docker exec -it jdmredis /bin/bash 


L7G MongoDB, 
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$ redis-cli 

$ config set requirepass mypass 
$ exit 

$ exit 


搭建 成 功 后 ， 可 以 使 用 Redis Desktop Manager 工具 查看 Redis，Auth 为 mypass。 
(4) 搭建 Zookeeper 


$ docker pull docker.io/zookeeper 
$ docker run --name jdmzookeeper -p 2181:2181 -p 2888:2888 -p 3888:3888 -d docker.io/zookeeper 


搭建 成 功 后 ， 可 以 使 用 Zooinspector 工具 查看 Zookeeper， 并 且 修 改 其 中 的 数据 内 容 。 
(5) 搭建 RabbitMQ 


$ docker pull docker.io/rabbitmq:3—management 
$ docker run —--name jdmrabbitmq -p 5672:5672 -p 15672:15672 -d rabbitmq:3-management 


使 用 如 上 命令 搭建 成 功 后 ， 可 以 访问 http://{ip}:15672 地 址 ， 输 入 账号 和 密码 〈 均 为 


guest)， 登 录 RabbitMQ 查看 。 
(6) 搭建 ElasticSearch 
搭建 ElasticSearch 需要 注意 环境 的 内 存 空间 ， 新 版 本 的 ElasticSearch 需要 内 存 较 大 ， 如 果 


自己 试验 时 可 以 搭建 老 版 本 的 ElasticSearch， 相 对 使 用 内 存 较 小 。 


$ docker pull docker.io/elasticsearch:2.4.0 

$ docker run —-name jdmelasticsearch -p 9200:9200 -p 9300:9300 -d docker.io/elasticsearch:2.4.0 
$ docker exec -it jdmelasticsearch /bin/bash 

$ cd bin/ 

$ ./plugin install mobz/elasticsearch-head® 

$ ./plugin install https://github.com/medcl/elasticsearch—analysis—ik/releases/download/v1.10.0/ 


elasticsearch-analysis-ik-1.10.0.zip® 


使 


$ cp ~r /etc/elasticsearch/analysis—ik /usr/share/elasticsearch/config/ 
$ cd /usr/share/elasticsearch/config/ 

$ chown -R elasticsearch.elasticsearch * 

$ exit 

$ docker restart jdmelasticsearch 


] 如 上 命令 ， 可 以 搭建 2.4.0 版 本 的 ElasticSearch， 包 括 ik 分 词 器 。 访问 http://{ip}: 


9200/_plugin/head/ 地 址 ， 可 以 看 到 Web 管理 页 面 。 
(7) 搭建 Kibana 


$ docker pull docker.io/kibana:4.6.6 
$ docker run -name jdmkibana -e ELASTICSEARCH URL=http://{ESip}:9200 -p 5601:5601 -d 


docker.io/kibana:4.6.6 

注意 上 面 的 命令 中 ELASTICSEARCH URL 属性 要 输入 ElasticSearch 的 地 址 。 使 用 如 上 方 
法 搭建 完毕 ， 可 以 访问 http://{ip}:5601 地 址 登录 Kibana。 

(8) 搭建 Logstash 


$ docker pull logstash 
$ docker run -it ~-rm logstash -e 'input { stdin { } } output { stdout { } }' 


© 注意 ElasticSearch 在 5.X 版 本 的 head 插件 已 经 不 支持 此 方法 安装 。 
© 安装 ElasticSearch 2.4.0 版 本 对 应 的 ik 分 词 器 版 本 为 1.10.0。 
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运行 如 上 命令 ， 然 后 在 命令 行 输入 测试 内 容 test logstash， 可 以 得 到 如 下 输出 。 


{ 
"@version" => "1", 
"host" => "696528decccb", 
"@timestamp" => 2018-05-14T06:31:56.482Z, 
"message" => "test logstash" 
} 
退出 运行 的 容器 ， 然 后 在 /etc/logstash/config-dir 目录 下 创建 logstash.conf 文件 ， 填 写 如 下 


input { 
file { 
path => "/logs/*/*" 
codec => "json" 
start_position => "beginning" 
} 
} 
filter { 
json { 
source => "message" 
} 
geoip { 
source => "ClientIp" 
} 
} 
output { 


elasticsearch { 
hosts => ["{ESip}:9200"] 
index => "logstash-% {+Y Y Y Y.MM.dd}" 


} 

以 上 内 容 是 logstash 的 采集 、 过 滤 及 输出 设置 。 日 志 采 集 的 位 置 是 /logs/*x*; 日 志 的 过 滤 
功能 可 以 根据 ClientIp 匹配 地 址 ， 最 后 输出 到 ElasticSearch 中 ， 根 据 日 期 定义 ElasticSearch 中 
的 index。 完 成 设置 后 运行 容器 : 

$ docker run —-name jdmlogstash -v /logs:/logs -p 5500:5500 -d -v "$PWD":/config-dir logstash -f 
/config-dir/logstash.conf 
(9) 搭建 Jenkins 


$ docker pull jenkins 

$ mkdir /home/jdm/jenkins 

$ chown -R 1000:1000 /home/jdm/jenkins 

$ docker run -itd -p 8089:8080 -p 50000:50000 -name jdmjenkins ——privileged=true -v /home/jdm/ 
jenkins:/var/jenkins_home Jenkins 


rajd 


安装 完成 后 ， 登 录 http://{ip}:8089 地 址 ， 会 进入 Jenkins 首次 使 用 页 面 ， 需 要 输入 密码 ， 
在 服务 器 中 ， 运 行 如 下 命令 获取 密码 : 
$ cat /home/jdm/jenkins/secrets/initial AdminPassword 


输入 密码 后 即 可 使 用 Jenkins。 
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本 章 介 绍 使 用 JenkinsS 进 行 软件 的 持 绢 
最 后 用 Rancher 管理 容器 的 运行 。 


20.1 Jenkins 基本 介绍 


团 


试 ， 从 而 尽快 地 发 现 集 成 错误 ， 让 
持续 集成 中 的 任何 一 个 环节 都 是 自动 完成 的 ， 无 需 太 多 的 人 了 


各 


KR 


BA 


~ 


日 构建 


卖 集 成 ， 然 后 自动 构建 程序 的 镜像 ， 


开发 成 员 协 同 工 作 ， 每 次 集 


成 都 是 通过 


节省 了 时 间 、 费 用 和 工作 量 。 


团队 能 够 更 快 进 行业 务 


发 。 


Jenkins 原名 Hudson， 是 一 人 
提供 详细 的 日 志文 件 和 提醒 功能 ，i 
Jenkins 的 优点 是 : 
图 易 安装 仅 需 一 
图 易 配 置 : Jenkins 提供 


图 代码 版 本 管理 支持 :Jenkins 能 


WebHook: 可 以 关联 提交 业务 


支持 分 布 式 构建 : 
集成 记录 信息 : 
信息 。 


E 文 持 第 三 方 插件 : 


Jenkins 4) 


20.2 Jenkins 基本 设置 


构 


本 节 简 要 介 


20.2.1 Jenkins 的 安装 


(1) 安装 JDK 
$ yum search jdk 


© Jenkins 的 官网 是 https://jenkins.io/。 
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开源 的 持续 人 
还 能 用 图 表 形 象 地 展示 项 


E 

m Æ E-Mail/RSS/M: 当 完 成 集成 时 ， 

E JUnit/TestNG 测试 报告 :以 图 表 等 形式 提供 详 旨 
= 以 把 集成 构建 等 工作 分 本 
E 


Jenkins 会 保存 每 次 集成 构建 产 


支持 扩展 插件 ， 可 以 定制 适合 团队 使 


| Jenkins 的 安装 方法 ， 包含 = 设置 


[干预 ， 有 利于 


E 送 至 Harbor 


在 讲解 Jenkins 之 前 ， 需 要 了 解 什么 是 持续 集成 。 持 续集 成 是 一 种 软件 开发 实践 ， 其 倡导 


动 化 的 构建 来 验证 ， 包 括 自动 编译 、 发 布 和 涡 


ERTH. 


个 war 包 ， 从 官网 下 载 该 文件 后 ， 直 接 运 行 。 
友好 的 GUI 配置 界面 。 

从 代码 仓库 (Git/Svn) ! 
尺码 的 事件 ， 


拉 取 代码 。 


Jenkins 能 实时 监控 集 
构建 的 趋势 和 稳定 性 。 


触发 Jenkins 的 自动 构建 项 目 。 


可 通过 这 些 工具 实时 通报 集成 结果 。 


的 测试 报表 功能 


生 的 jar 文件 ， 


用 的 a H o 


到 多 人 台 计 算 机 中 完成 。 
以 及 每 次 集成 构建 的 记录 


成 中 存在 的 错 


Git 和 Maven， 然 后 完成 Jenkins 环境 的 基本 
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$ yum install java-1.8.0-openjdk-devel.x86_64 -y 
$ java -version 


JDK 安装 完成 后 ， 注 意 JDK 的 安装 地 址 /usr/ibjvm， 这 个 地 址 在 配置 Jenkins 时 会 用 到 。 
(2) 安装 Git 

$ yum install git -y 

$ git version 
(3) 安装 Maven 


$ cd /usr/local 

$ wget http://mirror.bit.edu.cn/apache/maven/maven-3/3.5.3/binaries/apache-maven-3.5.3-bin.tar.gz° 
$ tar -zxvf apache—maven-3.5.3—bin.tar.gz 

$ rm -rf apache-maven-3.5.3-bin.tar.gz 

$ mv apache-maven-3.5.3 maven 


配置 环境 变量 ， 进 入 /etc/profile 文件 ， 添 加 如 下 配置 : 


export M2 HOME=/usr/local/maven 
export PATH=$PATH:$M2 HOME/bin 


然后 调用 如 下 命令 使 配置 生效 ， 并 且 查 看 Maven 版 本 : 


$ source /etc/profile 
$ mvn —version 


(4) 安装 Jenkins 
$ wget -O /etc/yum.repos.d/jenkins.repo https://pkg.jenkins.io/redhat-stable/jenkins.repo 
$ rpm —import https://pkg.jenkins.io/redhat-stable/jenkins.io.key 
$ yum install Jenkins 
安装 完成 后 ， 可 以 修改 Jenkins 设置 ， 例 如 进入 /etc/sysconfig/jenkins 文件 ， 修 改 
JENKINS PORT='"8088"， 这 样 就 把 Jenkins 对 外 提供 的 端口 修改 为 8088。 修 改 完 配置 后 ， 使 
用 如 下 命令 启动 Jenkins: 
$ service jenkins start 


至 此 ，Jenkins 的 相关 安装 工作 完成 。 


20.2.2 Jenkins 初次 使 用 配置 
使 用 上 一 节 介 绍 的 方法 安装 成 功 后 ， 访 问 Jenkins 的 地 址 http://{ip}:8088， 可 以 看 到 如 
图 20-1 所 示 页 面 ， 此 页 面 是 初次 使 用 Jenkins 的 提示 页 面 ， 需 要 输入 密码 。 
在 图 片 中 已 经 详细 提示 了 Jenkins 密码 的 路 径 ， 输 入 如 下 命令 获取 密码 : 
$ cat /var/lib/jenkins/secrets/initialAdminPassword 
在 页 面 中 输入 获取 的 密码 ， 可 以 进入 如 图 20-2 所 示 页 面 。 

选择 “安装 推荐 的 插件 ” 会 进入 一 个 安装 页 面 ， 如 图 20-3 所 示 ， 等 待 所 有 插件 安装 
插件 安装 完成 后 ， 进 入 用 户 设置 页 面 ， 如 图 20-4 所 示 ， 进 行 简单 的 用 户 账号 和 密码 设置 。 


如 果 此 地 址 不 可 下 载 ， 可 以 登录 http://maven.apache.org/download.cgi 选 择 其 他 下 载 地 址 。 
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新 手 入 i 


新 手 入 |] 


新 手 入 门 


Nise . 
解锁 jenkins 
为 了 确保 管理 员 安 全 地 安装 jenkins， 密 码 已 写 入 到 日 志 
服务 器 上 : 
/var/lib/jenkins/secrets/initialAdminPassword 
请 从 本 地 复制 密码 并 粘贴 到 下 面 。 
管理 员 密 码 
图 20-1 解锁 Jenkins 
m Ve . 
自 定义 jenkins 
插件 通过 附加 特性 来 扩展 jenkins 以 满足 不 同 的 需求 。 
安装 推荐 的 插件 选择 插件 来 安装 
Feria Se 选择 并 安装 最 适合 的 插件 。 
图 20-2 选择 插件 安装 
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** Pipeline: Supporting APIs 
** Durable Task 

** Pipeli 
** Matrix Pr 


s and Processes 


* 一 BE 


新 手 入 门 


创建 


javadevmap 
javadevmap 


子 郎 件 地 址 :your@emailcom 


图 20-4 创建 月 
上述 操作 ， 即 完成 了 Jenkins 基本 的 设置 了 


进行 了 -| 


第 一 个 管 于 


H 
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ERAF 


户 


CE. 


20.2.3 Jenkins 环境 变量 配置 


在 Jenkins 中 构建 项 目的 基本 流程 为 : Jenkins 
Maven 编译 、 打 包 。 为 了 完成 出 


任务 ， 需 要 Jenkins 具备 Git 
过 Maven 生成 Jar 包 ， 这 些 配置 就 是 对 Jenkins 环境 变 


从 Git/Svn 代码 库 获取 最 新 代码 ， 通 过 
等 相关 组 件 的 使 用 能 力 ， 并 且 通 


量 的 设置 。 


前 面 已 经 完成 了 JDK, Git. Maven 的 安装 ， 下 再 


径 ， 以 使 Jenkins 能 够 找到 这 些 组 件 。 
C1) 配置 JDK 地 址 
进入 “系统 管理 -> 全 局 


局 工具 配置 ”， 
JAVA_HOME 使 用 的 地 址 是 之 前 IDK 的 安装 地 址 。 


JDK 


JDK 安装 JDK 


别名 JDK 


JAVA HOME Jusrilib/jvm/java-1.8.0-openjdk-1.8.0 


找到 IDK 模块 ， 进 行 配置 ， 如 图 


要 在 Jenkins 中 配置 这 些 组 件 的 安装 路 


20-5 所 示 。 其 ! 


171-7.b10.el7.x86_64 


自动 安装 @ 
新 增 JDK 
系统 下 JDK SSF 
图 20-5 配置 JDK 

(2) 配置 Git 环境 变量 

同样 在 “系统 管理 -> 全 局 工具 配置 ”中 找到 Git 模块 ， 进 行 设 置 ， 如 图 20-6 所 示 。 

(3) 配置 Maven 环境 变量 

在 “系统 管理 -> 全 局 工具 配置 ”中 ， 进 行 Maven 的 配置 ，File path 中 填写 的 是 Maven 
的 配置 文件 地 址 ， 如 图 20-7 所 示 ; MAVEN HOME 中 填写 的 是 Maven 的 地 址 ， 如 图 20-8 
所 示 。 

进行 如 上 配置 后 ， 即 完成 了 构建 工程 相关 插件 的 基础 配置 工作 。 
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Git 
Git installations 
Git 
Name Default 
Path to Git executable git 
Back 
图 20-6 配置 Git 


X 全 局 工具 配置 


Maven Configuration 


Default settings provider Settings file in filesystem 


File path Jusr/local/maven/conf/settings xml 


Default global settings provider Use default maven global settings 


图 


Maven 


Maven 安装 Maven 


e 
Nams maven 


MAVEN_HOME lusr/local/maven| 


自动 安装 


新 增 Maven 


系统 下 Maven 安装 列表 


图 20-8 Me 


20-7 配置 Maven 


Maven 地 址 


20.2.4 Jenkins 日 志 级 别 设置 


Jenkins 的 默认 日 志 级 别 为 info， 默 认 日 志 存 放 在 /Var/log/jenkins/jenkins.log， 由 于 Jenkins 


默认 会 进行 DNS 查询 ， 因 


此 会 出 现 很 多 的 如 下 日 志 


400 


ES 
言 息 : 


type: TYPE IGNORE index 0, class: CLASS UNKNOWN index 


人 


1 


而 且 很 快 会 使 本 地 的 日 志文 件 变 得 
系统 日 
志 开 关 ， 如 图 20-9 所 示 。 


20.2.5 ”安装 常用 插件 
Jenkins 初次 启动 配置 

项 目 来 说 ， 还 是 不 够 的 ， 需 要 安装 
(1) 安装 Maven 插件 

在 Jenkins 中 构建 Maven 项 


其 他 几 个 相关 的 插件 


>» 


日 ， 需 安装 Maven 插 伯 
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民 大 。 此 时 可 以 取消 其 日 
me > AB” FEA RA javax.jmdns 的 级 别 修改 为 off， 这 样 就 关闭 了 DNS 服务 的 


o 


F， 因 


= 


JAD 


打印 。 办 法 是 : 在 “系统 管理 -> 


时 ， 用 户 可 以 按照 提示 安装 一 些 常用 的 推荐 插件 。 但 是 针对 Maven 


为 刚 安装 好 的 Jenkins 在 新 建 任务 


的 时 候 ， 并 没有 创建 Maven 工程 的 选项 ， 如 


章 
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而 


20-10 所 示 。 


Jenkins log 


日 志 级 别 


输入 一 个 任务 名 称 

该 字 彼 不 能 为 空 ， 请 输入 一 个 合法 的 名 称 

M 和 任 人 
流水 线 


本 |， 构建 一 个 多 配置 项 目 


(SP 适用 于 多 配置 项 目 ,例如 多 环境 测 | 


文件 夹 
创建 一 个 可 以 谋 套 存储 的 雁 器 。 利 用 它 可 以 进行 分 组 . 


GitHub Organization 


Multibranch Pipeline 


精心 地 组 织 一 个 可 以 长 期 运行 在 多 个 节点 上 的 任务 。 适 用 于 构建 流水 线 ( 更 加 正式 地 应 当 称 为 工作 流 ) 


视图 仅仅 是 一 个 过 小 器 , 而 文件 夹 则 是 一 个 独立 


日 志 配 置 @ 


名 称 级 别 
winstone 5 
org.apache.sshd WARNING 


INFO 


没有 名 称 的 是 默认 日 志 。 所 有 没 配置 级 别 的 日 志 将 继承 默认 日 志 


配置 级 别 


SFR: javax.jmdns 级 别 


i 
aD 


图 20-9 


系统 来 构建 你 的 项 目 , SEALER ELUM RS 


增加 或 者 组 织 难以 采用 自由 风格 的 任务 类 型 . 


间 ， 因 此 你 可 以 有 多 个 相同 各 称 的 的 内 容 ， 只 要 它们 在 不 同 的 文件 夹 里 即 可 。 


Scans a GitHub organization (or user account) for all repositories matching some defined markers. 


Creates a set of Pipeline projects according to detected branches in one SCM repository 


可 选 插件 ”界面 搜索 安装 。 在 右 


由 于 Jenkins 默认 没有 创建 Maven 项 目 任 务 的 选项 ， 


图 20-10 ”默认 项 


创建 页 面 


所 以 需要 在 “系统 设置 -> 插件 管理 -> 
上 角 的 输入 框 填写 “Maven Integration ”并 搜索 ， 可 以 看 到 搜 


索 结 果 ， 如 图 20-11 所 示 。 


Cr > 


javadevmap 1 注销 


ii: |9, Maven Integration 
可 选 插件 
名 称 版 本 
Maven Integration 
3.1.2 
35.6 


TR sree MELO 
ET rr EE 


图 20-11 搜索 Maven 插件 
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这 里 勾 选 Maven Integration 选项 ， 然 后 点 击 直接 安装 即 可 。 安 装 完 成 后 ， 就 能 在 新 建 任务 
时 出 现 “ 构 建 一 个 Maven 项 目 ” 的 选项 。 

(2) 安装 Publish Over SSH 插件 

一 般 部 署 操 作 ， 需 要 在 项 目 构 建 完 成 后 ， 将 项 目 生 成 的 文件 ， 通 过 SSH 复制 到 目标 服务 
器 ， 然 后 执行 命令 或 自 定 义 shell 脚本 直接 启动 服务 。 而 Publish Over SSH 插件 正好 可 以 胜任 
此 需求 。 
在 “系统 设置 -> 插件 管理 -> 可 选 插件 ”界面 搜索 安装 ， 在 右上 角 的 输入 框 


Am 


15 “Publish 


Ni 


Over SSH” 并 搜索 ， 可 以 看 到 搜索 结果 ， 如 图 20-12 所 示 。 
®@ Jenkins 


svi: [@ Publish Over SSH] 


可 选 插件 


安装 | 名 称 版 本 
Publish Over SSH 


er 


图 20-12 ”安装 Publish Over SSH 插件 
点 击 直接 安装 ， 等 待 插件 安装 完成 后 ， 需 要 到 “系统 管理 -> 系统 设置 ”中 添加 SSH 
Server 配置 ， 方 便 每 个 任务 在 完成 构建 后 ， 将 生成 的 可 执行 文件 推送 至 目标 服务 器 。 如 
图 20-13 所 示 。 


SSH Servers SSH Server 


172.17.238.239_javadevmap 
172.17.238.239 


root 


© © © © 


Remote Directory /gatajavadevmap/Spring_Cloud 


图 20-13 添加 SSH Server 


加 Name: SSH 标识 的 名 字 ， 自 定义 即 可 。 

E HostName: 需要 连接 SSH 的 主机 名 或 卫 地 址 。 

E Username: SSH 连接 登录 目标 IP 服务 器 所 使 用 的 用 户 名 。 

E Remote Directory: 用 SSH 连接 后 的 远程 根 目 录 ， 这 个 目录 是 必须 存在 的 ， 原 因 是 
Jenkins 不 会 自动 创建 此 目录 。Jenkins 会 将 文件 远程 复制 到 该 目录 。( 注 意 : SSH 连接 
的 用 户 需 要 有 权限 才 可 以 创建 、 删 除 、 移 动 文件 及 文件 夹 )。 

完成 配置 后 ， 可 以 点 击 Test Configuration 测试 配置 是 否 成 功 ， 如 果 出 现 Success 表示 

成 功 。 


z| 


20.3 ”构建 Maven 项 目 


接 下 来 通过 Jenkins 构建 第 9 章 中 的 Eureka 服务 ， 实 现 Eureka 服务 的 Maven 打包 以 及 发 
布 运行 操作 。 
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20.3.1 Maven 构建 设置 


(1) 创建 Maven 项 目 。 
新 建 一 个 通过 Maven 构建 的 项 目 SpringCloudEureka， 然 后 点 击 确定 。 如 图 20-14 所 示 。 


输入 一 个 任务 名 称 
SpringCloudEureka 


» CATR 


(a 构建 一 个 自由 风格 的 软件 项 目 
\ 更 ”这 是 Jenkins 的 主要 功能 Jenkins 将 会 结合 任何 SCM 和 任何 构建 系统 来 构建 你 的 项 目 , 甚至 可 以 构建 软件 以 外 的 系统 


构建 一 个 maven 项 目 
构建 一 个 maven 项 目 .Jenkins 利 用 你 的 POM 文 件 ,这 样 可 以 大 大 减轻 构建 配置 


流水 线 
2 精心 地 组 织 一 个 可 以 长 期 运行 在 多 个 节点 上 的 任务 。 适 用 于 构建 流水 线 ( 更 加 正式 地 应 当 称 为 工作 流 ) ， 增 加 或 者 组 织 难以 采用 自由 风格 的 任务 类 型 . 
x] 构建 一 个 多 配置 项 目 
IZV 适用 于 多 配置 项 目 ,例如 多 环境 测试 ,平台 指定 构建 等 等 


= 文件 夹 
| 创建 一 个 可 以 嵌 套 存储 的 容器 。 利 用 它 可 以 进行 分 组 。 视图 仅仅 是 一 个 过 滤器 ， 而 文件 夹 则 是 一 个 独立 的 命名 空间 ， 因 此 你 可 以 有 多 个 相同 名 称 的 的 内 雁 ， 只 要 它们 在 不 同 的 文件 夹 里 即 可 。 


_» GitHub Organization 
(©). scans a GitHub organization (or user account) for all repositories matching some defined markers. 


Multibranch Pipeline 
Creates a set of Pipeline projects according to detected branches in one SCM repository. 


Ri 


20-14 创建 Maven 项 目 


(2) 填写 项 目 名 称 与 描述 。 
在 接 下 来 的 页 面 中 ， 填 写 项 目 名 称 为 SpringCloudEureka， 描 述 为 Eureka Projecto 4N 
20-15 所 示 。 


General Sse 构建 触发 器 构建 环境 e Step: Build F St 构建 设置 构建 后 操作 
项 目 和 名称 SpringCloudEureka 
措 述 Eureka Project 


(SAR) 预览 


图 20-15 输入 工程 信息 


(3) 设置 构建 的 保存 期 限 ， 如 图 20-16 所 示 。 
4 丢弃 |B 的 构建 © 
Strategy Log Rotation 
保持 构建 的 天 : 7 < 


如 果 非 空 ， 构建 记录 将 保存 此 天 数 
保持 构建 的 最 大 个 数 3 


如 果 非 空 ， 最 多 此 数目 的 构建 记录 将 被 保存 


图 20-16 设置 构建 保存 期 限 
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(4) 设置 代码 地 址 。 
在 这 里 填写 Git 的 工程 地 址 ， 并 且 在 Credentials 中 配置 Git 的 账号 密码 。 如 图 20-17 所 示 。 


® Git 


Repositories (2) 
Repository URL _ https://gitee.com/hwhe/JavaDeveloperMap git © 


Credentials hwhewei@foxmail.com/****** -Pea 
mR... 


Add Repository 


Branches to build Ea 


Branch Specifier (blank for any) */master @ 


Add Branch 


图 20-17 设置 Git 仓库 信息 
(5) 设置 编译 的 pom 文件 路 径 以 及 命令 ， 如 图 20-18 所 示 。 
完成 如 上 配置 后 ， 保 存 ， 然 后 点 击 工程 的 “立即 构建 ”就 可 以 构建 此 Maven 工程 了 。 第 

一 次 构建 时 需要 下 载 依赖 包 ， 所 以 构建 时 间 较 长 ， 下 载 完 成 后 的 下 一 次 构建 会 比较 快 。 


Build 
Root POM SpringCloudEureka/pom xml © 
Goals and options clean install -Dmaven.test skip=true @ 


图 20-18 ”设置 pom 文件 路 径 及 命令 


20.3.2 ”服务 的 执行 


上 一 节 已 经 完成 了 Maven 工程 的 构建 ， 构 建 后 的 jar 包 存 放 在 Jenkins 服务 器 中 的 
/var/lib/jenkins/workspace 路 径 下 相应 工程 的 目录 中 。 下 面 要 做 的 事情 就 是 把 此 jar 推送 到 要 运 
行 此 服务 的 服务 器 并 且 局 动 运行 。 

(1) 配置 运行 脚本 
在 服务 要 运行 的 服务 器 中 添加 运行 脚本 ， 此 脚本 的 目的 就 是 启动 此 服务 。 进 入 /data/ 


javadevmap/sc_shell 目录 ， 新 建文 件 eureka _start.sh， 在 文件 中 填写 如 下 内 容 : 

#!/bin/sh 

echo "eureka stop" 

curl -X POST 172.17.238.239:18001/shutdown? 

echo "eureka stop ok!" 

sleep 20s 

echo "eureka start!" 

nohup command>/data/javadevmap/Spring Cloud/SpringCloudEureka/eureka.file 2>&1 java -jar —Xmx 
128m/data/javadevmap/Spring_Cloud/SpringCloudEureka/SpringCloudEureka—0.0.1-SNAPSHOT jar —spring. 
profiles. active=eurekaA & 


pare 


O 请 注意 服务 的 /shutdown 端点 关闭 服务 的 耗 时 以 及 是 否 正确 关闭 了 服务 。 
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echo "eureka end!" 
然后 设置 此 文件 的 运行 权限 。 
$ chmod u+x eureka_start.sh 
(2) 配置 Jenkins 构建 后 操作 
进入 Jenkins 中 的 SpringCloudEureka 工程 的 配置 页 ， 在 “构建 后 操作 ”选项 中 选择 “Send 
build artifacts over SSH”， 然 后 进行 配置 ， 如 图 20-19 所 示 。 


= 
构建 后 操作 
Send build artifacts over SSH 加 (2) 
SSH Publishers 
SSH Server 
Name 172.17.238.239 javadevmap " © 
高 级 … 
Transfers 
Transfer Set 
Source files SpringCloudEureka/target/* jar © 
© 
Remove prefix SpringCloudEureka/target/ © 
Remote directory /SpringCloudEureka (2) 
Execcommand _/data/javadevmap/sc_shell/eureka_start.sh & i © 
o Either Source files, Exec command or both must be 
supplied 
All of the transfer fields (except for Exec timeout) support 
substitution of Jenkins environment variables 
高 级 … 
Add Transfer Set 
Add Server 


图 20-19 配置 推送 到 的 服务 器 及 执行 脚本 


E SSH Server-Name: 选择 系统 设置 中 已 添加 的 SSH 服务 器 。 
E Source files: 需要 上 传 到 应 用 服务 器 的 文件 〈 注 意 : 相对 于 Jenkins 工作 空间 的 路 径 )。 
E Remove prefix: 去 掉 目 录 前 级 (只 能 指定 Source files 中 的 目录 )。 
E Remote directory: 目标 服务 器 的 文件 夹 。 
E Exec command: 远程 服务 器 要 执行 的 命令 。 在 远程 SSH 传输 执行 后 ， 才 会 执行 这 里 配 
置 的 脚本 命令 ， 此 脚本 即 上 面 所 展示 的 运行 Eureka 服务 的 脚本 。 
(3) 自动 构建 及 服务 运行 
现在 Jenkins 自动 构建 已 经 配置 完毕 ， 进 入 Jenkins 中 的 SpringCloudEureka 任务 中 ， 点 避 
“立即 构建 ” 如 图 20-20 所 示 ， ee. 
可 以 在 控制 台 输 出 区 查看 Jenkins 的 构建 过 程 ， 在 此 任务 中 ， 最 后 输出 的 内 容 为 
eureka stop 
{"message":"Shutting down, bye..."}eureka stop ok! 


eureka start! 
eureka end! 


le 


ott 
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SSH: EXEC: completed after 20,223 ms 


SSH: Disconnecting configuration [172.17.238.239_javadevmap] ... 


SSH: Transferred 1 file(s) 
Finished: SUCCESS 


@ Jenki S 


Eureka Project 


构建 历史 一 


国 BSS 全 部 国 RSS 失败 


图 20-20 


服务 自动 构建 


待 自 动 构建 及 服务 运行 
Eureka 的 可 视 化 页 面 。 这 样 
要 点 击 Jenkins 的 构建 按钮 即 可 ， 不 需要 其 
Jenkins 对 工作 效率 的 提升 是 很 明显 的 。 


>» 


20.4 Harbor 镜像 管理 


工程 如 果 要 通过 Docker 运行 ， 
么 镜像 生成 后 放 到 哪 旦 
种 情况 下 就 需要 一 个 私有 的 镜像 仓库 来 存 


前 提 是 把 


Harbor 是 


可 以 登录 目标 服务 器 查看 服务 运 4 
整个 服务 的 自动 化 部 署 流 程 就 完成 了 。 在 服务 启动 的 过 程 ! 


查看 


I AN 


J 情况 或 通过 浏览 


他 操作 即 完成 了 一 个 服务 的 编译 及 运行 ， 可 见 


可 执行 文件 通过 Dockerfile 的 形式 生成 镜像 。 那 


AME? 如 果 多 台 服 务 器 要 部 署 某 一 镜像 ， 手 动 拖 来 拖 去 明显 是 低 效 的 ， 这 
OZ 
开源 的 企业 级 的 Docker Registry 管理 


成 好 的 镜像 。 


EMH, ‘ELA Docker 开源 的 registry 为 基 


>» 


础 ， 提 供 了 权限 管理 (RBAC)、LDAP、 
持 等 功能 


20.4.1 Harbor 安装 


is 


(1) 安装 Docker-compose 


首先 确认 服务 器 已 


经 安装 好 了 Docker， 然 后 执行 如 下 命 


界面 、 自 我 注册 、 镜 像 复 制 和 中 文 文 


£ As 
An E 


令 安 装 Docker-compose。 


$ curl -L https://github.com/docker/compose/releases/download/1.21.2/docker-compose-‘uname -S 一 


“uname -m ~o /usr/local/bin/docker-compose 
$ chmod +x /usr/local/bin/docker-compose 
$ docker-compose version 


(2) 下 载 Harbor 安装 文件 3 
$ mkdir /usr/local/harbor 
$ cd /usr/local/harbor 


运行 


$ wget https://storage.googleapis.com/harbor-releases/release-1.5.0/harbor-offline-installer-v1.5.0-rc2.tgz 
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$ tar -xvf harbor-offline-installer-v1.5.0-rc2.tgz 


解压 缩 后 ， 可 以 查看 harborcfg 文件 ， 这 是 Harbor 的 配置 文件 。 可 以 修改 hostname 


为 自己 的 卫 地 址 ， 文 件 中 包含 Harbor 的 默认 密码 Harbor12345。 


执行 ./install.sh 脚本 ，Harbor 会 自动 下 载 相应 组 件 并 且 安 装运 行 。 成 功 后 执行 docker ps fit 
令 ， 可 以 看 到 如 图 20-21 所 示 输 出 。 


3joe192t cua9apz harbor]# docker ps 


性 


Wh 


wl 


PORTS 


Cheathy) 0.0.0.0:80->80/tcp, 0.0.0. 0:443->443/tcp, 0.0. 0. 0:4443->4443/tcp 


K| 20-21 Harbor ser 

访问 http://{ip}， 输 入 账号 admin， 密 码 Harbor12345， 可 以 进入 Harbor. 
20.4.2 ”生成 镜像 并 保存 

现在 Harbor 仓库 已 经 搭建 完毕 ， 下 面 做 的 事情 就 是 通过 Jenkins 生成 镜像 ， 然 后 把 镜像 推 
送 至 Harbor 仓库 。 

(1) 镜像 推送 前 准备 
在 将 要 生成 镜像 的 服务 器 中 ， 先 关 掉 Harbor 仓库 的 安全 认证 。 新 建 /etc/default/docker 文 
件 ， 文 件 中 填写 如 下 内 容 : 


—-insecure-tegistry={your harbor ip} 
OPTIONS= '~-selinux-enabled ——log-driver=journald —-signature-verification=false ——insecure— 
registry= {your harbor ip}" 


9K Ja 1E/usr/lib/systemd/system/docker.service 文件 中 添加 如 下 内 容 : 
EnvironmentFile=—/etc/default/docker 
使 用 如 下 命令 重启 Docker: 


$ systemctl daemon-reload 
$ systemctl restart docker 


(2) 设置 Jenkins 
以 之 前 编写 的 SpringCloudServiceProvider 工程 为 例 ， 在 Jenkins 中 新 建 一 个 任务 ， 这 个 任 
务 的 作用 就 是 编译 Provider 工程 ， 并 且 把 此 工程 的 jar 文件 推送 至 镜像 生成 服务 器 ， 然 后 运行 
此 服务 器 中 的 一 个 脚本 ， 生 成 Provider 工程 的 镜像 并 且 推送 至 Harbor 仓库 。 此 工程 的 编译 部 
分 与 之 前 介绍 Jenkins 生成 jar 文件 相同 ， 只 要 配置 好 工程 名 和 路 径 即 可 ， 推 送 和 运行 脚本 部 分 
有 一 点 需要 注意 ， 就 是 jar 文件 的 文件 夹 要 和 脚本 文件 夹 相 同 ， 如 图 20-22 所 示 。 
(3) 镜像 生成 服务 器 配置 
在 Jenkins 推送 到 的 目录 中 ， 要 准备 好 生成 镜像 的 Dockerfile 文件 和 可 执行 脚本 
provider image.sh Dockerfile 文件 的 作用 正如 第 19 章 所 介绍 ， 是 镜像 生成 的 配置 而 
provider image.sh 文件 的 作用 是 调用 生成 镜像 的 命令 并 推送 镜像 至 Harbor。 
Dockerfile 文件 配置 如 下 : 
FROM java:8 
ADD SpringCloudServiceProvider-0.0.1-SNAPSHOT.jar /data/run/ 


EXPOSE 18010 
WORKDIR /data/run/ 


ENTRYPOINT ["java","-jar",""SpringCloudServiceProvider—0.0.1-SNAPSHOT jar","——spring. profiles. 
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active=providerA"] 


工程 名 相同 ， 这 里 创建 项 目 


` 


构建 后 操作 
Send build artifacts over SSH 
SSH Publishers 
SSH Server 
Name 


Transfers 
Transfer Set 


Source files 


Remove prefix 


Remote directory 


Exec command 


Add Transfer Set 


provider_start.sh 文件 配 
#!/bin/sh 


172.17.238.239_javadevmap 


SpringCloudServiceProvideritarget jar 


SpringCloudServiceProvideritarget/ 


/SpringCloudServiceProviderimage 


/data/javadevmap/Spring_Cloud/SpringCloudServiceProviderimage/provider_image.sh 中 


E, 


"© 


@ Either Source files, Exec command or both must be supplied 
All of the transfer fields (except for Exec timeout) support substitution of Jenkins environment variables 


Ww 


图 20-22 
置 如 下 : 


Bet 


q. Jenkins 


E 送 目的 地 及 脚本 


cd /data/javadevmap/Spring Cloud/SpringCloudServiceProviderImage 


Date_ time= date "+%F 


-%H-%M" 


docker build -t 172.17.238.239/springcloud/provider:0.0.1.${Date_time} . 
docker login 172.17.238.239 —-username admin ——-password Harbor12345 
docker push 172.17.238.239/springcloud/provider:0.0.1.${Date_time} 


添加 完 文 件 后 
(4) Harbor 仓库 添加 项 
在 Harbor 中 ， 要 先 添 力 


上 一 个 项 目 月 


名 称 为 springcloud 。 


图 20-23、 图 


名， 这 里 就 不 再 演示 。 

(5) 执行 效果 
在 Jenkins PHT “ZR 
上 是 把 镜像 
20-24 所 示 。 


springcloud 


镜像 仓库 


成 员 S5 


名 称 
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” 


sey 


’ 
» 


0 构建 


后 观察 构建 进度 ， 可 以 发 现 项 目 编 
ESP Harbor GE, Æ Harbor 的 镜像 仓库 中 可 以 看 到 镜像 文件 列表 ， 如 


， 记 得 执行 chmod utx provider_image.sh 命令 设置 文件 权限 。 


日 于 承接 推送 到 Harbor 的 镜像 ， 此 项 目 名 称 要 和 镜像 


于 Harbor 的 可 视 化 页 面 操作 起 来 较为 简 


;又 上 


TEJO 


成 后 执行 了 镜像 


Q| a E 


PUSH_IMAGE.TITLE ~ 


下 载 数 


图 20-23 Harbor 仓库 镜像 
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springcloud/provider 
REPOSITORY .INFO REPOSITORY IMAGE 
ale 
标签 REPOSITORY.SIZE Pull 命 令 作者 创建 时 间 oe REPOSITORY.LABELS 

2018/5/16 下 午 

m 18/5/16 下 午 

34 m KA 

| 1 下 午 2 

图 20-24 Harbor 仓库 镜像 文件 
20.5 Rancher 容器 管理 

前 面 已 经 把 自己 的 工程 生成 为 镜像 ， 并 且 保 存 到 镜像 仓库 中 ， 下 一 步 就 需要 运行 此 镜像 生 
成 Docker 容器 ， 这 样 容器 中 运行 的 服务 就 可 以 对 外 提供 业务 能 力 ， 此 服务 通过 Eureka 注册 中 


心 成 为 整个 Spring Cloud 集群 的 一 部 分 。 


Rancher 是 一 个 玫 


察 容器 中 服务 


F 源 的 企业 级 容器 管理 


AST 
ner J 
Fy 


平台 ， 


FH 


下 面 使 


H Rancher 


启动 容器 后 ， 观 察 Eureka 的 服务 注册 情况 ， 并 且 对 Spring Cloud 集群 


的 负载 情况 。 


20.5.1 Rancher 的 安装 及 主机 添加 
(1) Rancher 的 安装 


Rancher 使 月 
。 在 服务 器 中 执行 如 下 命令 即 可 完成 安装 。 


日 容器 化 


roj 


XR 


所 以 安装 Rancher 的 服务 器 需要 保 订 


$ docker run -d —restart=always -p 8080:8080 rancher/server 


ZRA, H 


(2) 添加 


进入 Rancher 可 视 化 页 面 后 ， 选 择 “ 基 础 


所 示 页 面 。 


Hix Sah a 


主机 


可 以 修改 主机 注册 地 址 为 其 他 地 址 2， 点 了 


访问 http://{ip}:8080 地 址 即 可 看 到 Rancher 的 可 视 化 页 面 。 


架构 -> 主机 -> 添加 主机 ”， 可 以 看 到 如 


20-26 所 示 ， 此 引导 页 描述 得 非常 清楚 ， 按 照 此 引导 页 的 说 明 添加 主机 即 可 。 


按照 提示 ， 在 需要 加 入 Rancher 


Rancher HJ “JE fi 


(3) 添加 私有 镜像 仓库 


选择 “基础 架构 -> 镜像 库 ” 如 图 


架构 一 主机 ” AT IL 


集群 的 主机 


na 


执行 图 
20-27 所 示 主 机 实例 。 


O 本 书 中 选择 了 其 


改 主机 注册 地 址 。 


他 地 址 ， 把 半 


E 机 注册 地 址 修改 为 一 个 内 网 地 址 ， 如 果 此 处 忘记 修改 ， 


可 以 在 “系统 管理 -> 系统 设置 ” 


里 容器 ， 通 过 Rancher 
的 Zuul 进行 访问 ， 观 


FE 已 经 安装 好 了 Docker 环 


20-25 


fi 保存 后 ， 可 以 看 到 一 个 添加 主机 的 引导 页 ， 如 


EIT 


20-28 所 示 ， 按 照 页 面 提 示 添 加 刚 创建 的 Harbor 仓库 。 


g 


HG 
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记得 添加 自 定义 的 仓库 需要 选择 CUSTOM 类 型 。 


BPE 。 人 Defautv My 应 用 商店 v 


在 添加 第 一 个 服务 或 容器 之 前 ， 必 须 至 少 添加 一 台 安 装 了 
主机 :添加 主机 


主机 注册 地 址 


ver API 的 Ba RL 是 


图 20-25 ”添加 主机 


pr 


Le 
Custom 


管理 docker-machine 驱 动 


1 ”启动 一 台 Linux 主 机 并 在 主机 上 安装 好 我 们 支持 的 版 本 的 Docker。 


2 确认 安全 组 或 防火 墙 多 许 以 下 通讯 
o 与 其 他 所 有 主机 之 间 的 UDP 端口 soo 和 4566 (用 于 |P 


3 ”可 选项 :在 主机 上 增加 标签 


(办 添加 标签 


的 Linux 主 机 。 


packet 


4 MEEF 注册 这 全 主机 的 公 网 |P。 如 果 留 空 ，Rancher 会 自动 检测 IP 注 册 。 通 常 在 主机 有 唯一 公 网 IP 的 情况 下 这 是 可 以 的 。 如 果 主 机 位 于 防火 墙 /NAT 设 备 之 后 ， 或 者 主机 同时 也 是 运行 


er 容器 的 主机 时 ， 则 必须 设置 此 IP。 
5 ”将 下 列 脚本 拷贝 到 每 一 台 主机 上 运行 以 注册 Rancher: 


6 ”点 击 下 面 的 关闭 按钮 ， 新 的 主机 注册 后 会 显示 在 主机 页 面 。 


Eel 


20.5.2 Rancher 启动 单一 容器 


下 面 使 用 Rancher 启动 
镜像 。 
启动 容器 配置 。 在 单 台 主 机 的 列表 下 方 ， 有 
图 20-29 所 示 页 面 。 


标签 ， 在 网 络 选 项 中 选择 主机 模式 ， 如 图 20-30 所 示 。 
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图 20-26 添加 主机 引导 页 


个 “添加 容器 ”选项 ， 选 择 该 


一 个 容器 ， 这 个 容器 使 用 的 镜像 就 是 之 前 用 Provider 服务 创建 的 


玄 选 项 后 可 见 如 


在 页 面 中 可 以 配置 容器 名 称 、 镜 像 地址 以 及 拉 取 镜像 规则 。 设 置 完 这 些 内 容 后 ， 选 择 网 络 


Pr 合 Default v 


主机 


docker 


应 用 : healthcheck 


应 用 v 应 用 商店 


healthcheck-1 10.42.200.154 Ë 


应 用 :ipsec 

cni-driver-1 

ipsec-1 10.42.208.184 ? 
MC 


应 用 : network-services 
network-manager-1 


metadata-1 


选择 镜像 " 


图 20-27 主机 实例 


172.17.238.239/springcioud/provider:0.0.1.2018-05-16-14-51 


6s 8 RE Ses Sk BENE 标签” 调度 


卷 


网 络 


Oriara 


WS ”安全 /主机 Ek ”健康 检查 


基础 架构 Y 


图 20-30 


添加 镜像 库 


地 址 * 


172.17.238.239 


用 户 名 


admin 


iat 


Oroes 
用 户 
AMET HOR SE 
aie, Be 
创建 取消 


图 20-29 ”启动 单一 容器 


he WE 


设置 网 络 模式 
然后 选择 卷 标 签 ， 添 加 卷 ， 让 容器 内 的 卷 可 以 映射 到 主机 ， 如 图 


图 20-28 
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© 


Custom 


添加 镜像 库 


20-31 所 示 。 


完成 如 上 配置 后 ， 点 击 “ 创 建 ”， 可 以 看 到 容器 启动 了 ， 如 图 20-32 所 示 。 
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eo è MS ”安全 /主机 Ek ”健康 检查 ”标签 ”调度 


图 20-31 添加 卷 


容器 :Oprovider 
fi 
docker o 用 ozea 
ail YC 
J 

Docker ID: 
c28f133768eb. 
172.17.238.239/springcloud/provider:0.0.1.2018-05-16-14-51 网 络 Pe Ol = o3 Of 
创建 于 
afew seconds ago 

BU @o © MS Re RE 标签。 WE 

1P 地 址 Ee 容器 私有 端口 


图 20-32 ”容器 监控 信息 
进入 此 台 主 机 的 /logs 目录 ， 可 以 看 到 容器 中 的 服务 日 志 已 经 挂 载 出 来 ， 执 行 tail 于 命令 可 
以 和 本 机 上 服务 一 样 查 看 日 志 打 印 。 使 用 Postman 单独 访问 此 服务 ， 也 可 以 正确 返回 数据 。 
这 样 单个 容器 的 运行 已 经 完全 可 以 使 用 此 方法 进行 操作 ， 但 是 Rancher 的 目标 肯定 不 只 是 
运行 单 节点 服务 ， 下 一 节 介 绍 快速 部 署 大 量 服务 实例 。 


20.5.3 Rancher 启动 批量 容器 


在 服务 集群 中 ， 每 个 服务 都 会 启动 多 个 实例 ， 当 用 Docker 运行 服务 容器 ， 用 Rancher 管 
理 容器 时 ， 也 希望 Rancher 能 够 提供 简单 、 快 速 的 服务 启动 及 监控 能 力 。 下 面 就 演示 一 种 服务 
容器 批量 启动 的 方法 。 
(1) 添加 多 台 主 机 
使 用 上 一 节 介 绍 的 方法 ， 在 另外 一 台 服 务 器 中 运行 Rancher 注册 命令 ， 把 新 服务 器 加 入 
Rancher 主机 集群 中 。 如 图 20-33 所 示 。 

(2) 给 主机 添加 标签 

点 击 主机 右上 角 的 按钮 ， 在 弹出 框 中 选择 “编辑 ” 在 弹出 1 
台 主 机 添加 springcloud=provider 标签 。 如 图 20-34 所 示 。 


=n EEA 


= 


中 添加 标签 ， 例 如 给 上 面 两 


yer ServerB 
serverA ServerB si ye 
springdoud=provider 
应 用 : healthcheck 应 用 : healthcheck = 

应 用 : healthcheck 应 用 : healthcheck 
healthcheck-1 10.42.200.154 healthcheck-2 10.42.120.21 oa aA din gd healthcheck-2 10.42.120.217 

pees [大 m ` » 一 局 

图 20-33 Rancher 管理 的 两 台 主机 图 20-34 设置 主机 标签 
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(3) 在 Rancher 中 创建 应 用 和 服务 
在 Rancher 中 选择 “应 用 -> 添加 应 


j”， 这 里 输入 应 用 名 springcloud 


A 
O 


AHP, W RRE”. IRA E 


“总 是 在 每 台 主机 上 运行 一 个 此 容器 的 实例 ” 如 图 20-35 所 示 。 
添加 服务 
数量 


Run 1 个 容器 — 


® 总 是 在 每 台 主机 上 运行 一 个 此 容器 的 实例 


名 称 描述 
provider provider 
选择 镜像 * 四 创建 前 总 是 拉 取 漳 像 


172.17.238.239/springcloud/provider:0.0.1.2018-05-16-14-51 


图 


20-35 Ki 


容器 运行 数量 


另 一 个 不 同 的 地 方 是 添加 调度 规则 ， 进 入 “调度 -> 添加 调度 规则 ”， 这 呈 


springcloud=provider 标签 的 主机 启动 此 容器 ， 如 


图 20-36 所 示 。 


第 20 章 


项 目 构建 


。 然 后 进入 刚 创建 的 


容器 不 同 的 地 方 有 两 处 ， 一 是 在 数量 选项 中 选择 


配置 所 有 


ao 卷 MS 安全 /主机 Sx MAME HE HE 
在 指定 主机 上 运行 全 部 容器 

® 自动 在 符合 调度 规则 的 每 一 台 主 机 上 运行 : 

(DD 添加 调度 规则 

主机 必须 县 有 主机 标签 其 springcloud ~ provider |-| 


图 调度 规则 
配置 完 上 述 信息 后 ， 还 要 配置 网 络 和 卷 ， 方 法 和 启动 单个 容器 相同 ， 然 后 点 击 
动容 器 ， 可 见 两 台 主 机 会 同时 启动 Provider 服务 容器 。 如 图 20-37 所 示 。 


服务 : 


描述 
provider 


20-36 ii 


IT 


“创建 ” 启 


provider v inspringcloud 


类 型 


服务 镜像 统计 
数量 : 
全 局 


serverA 172.17.238.239/spri. 


镜像 : 
172.17.238.239/springcloud/provider:0.0.1.2018: 
05-16-14-51 


172.17.238.239/spri. 


AQ: 


命令: 


IT 


Rau 


20-37 ARS 
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在 此 页 面 中 ， 可 以 点 击 单 


No 


Instances currently registered with Eureka 


ANAS J TALS EA 
在 Eureka 中 可 以 看 到 新 启动 的 两 个 Provider 服务 ， 如 


em mai 
W% ’ 


EE， 选 择 “ 查 看 
图 20-38 所 示 。 


即 可 看 到 此 服务 的 日 


Application AMIs Availability Zones Status 

CONFIG-SERVER n/a (1) (1) UP (1) - 172 

EUREKA-SERVER n/a (2) (2) UP (2)-1 

SERVICE-CONSUMER n/a (1) (1) UP (1) - 172.17.238.237:18020 

SERVICE-PROVIDER n/a (4) (4) UP 区 CE 
TURBINE n/a (1) (1) UP (1) - 

ZIPKIN-SERVER n/a (1) (1) UP (1)-1 

ZUUL n/a (1) (1) UP (1) - 172. 17.238.237:180 


Ka 


20-38 Eureka 服务 注册 列表 


通过 Zuul 访问 此 服务 ， 查 看 日 志 ， 可 以 看 到 几 个 Provider 服务 实例 均匀 承担 请 求 压 力 。 


20.5.4 服务 更 新 


前 面 介绍 了 Rancher 的 批量 部 署 ， 其 实 


它 还 具备 一 个 较为 方便 好 用 的 服务 升级 能 力 。 


Rancher 的 服务 升级 不 只 是 简单 的 更 新 服务 容器 ， 


还 带 了 一 个 简便 好 用 的 回 


滚 功 能 ， 当 服务 新 


版 本 不 可 用 ， 需 要 回 退 的 时 候 ， 可 以 一 键 实 现 回 j 
(1) 升级 


p 


IR o 


进入 新 建 的 springcloud 应 用 中 


>» 


可 以 看 到 应 


所 包含 的 服务 ， 单 个 服务 的 最 右 侧 多 选 


杠 ， 有 一 个 升级 按钮 。 如 图 20-39 所 示 。 
应 用 : springcloud v 添加 服务 v 
图 20-39 ”服务 操作 菜单 
点 击 此 按钮 ， 在 新 的 弹出 页 中 ， 只 要 输入 新 的 镜像 地 址 ， 并 且 配 置 简 单 的 升级 规则 ， 就 可 
以 实现 服务 升级 ， 如 图 20-40 所 示 。 
升级 服务 
批量 大 小 批量 间隔 启动 行为 
t 2 4 先 启动 再 停止 
选择 镜像 * 4 创建 前 总 是 拉 取 镜像 


172.17.238.239/springcloud/provider:0.0.1.2018-05-17-12-19 


图 20-40 ”服务 升级 规则 
(2) ER 
服务 升级 后 ， 查 看 此 服务 运行 的 容器 ， 可 见 新 老 容 器 都 存在 ， 只 是 老 容器 是 Stopped JÑ 


Z] 


态 ， 如 图 20-41 所 示 。 这 就 方便 了 服务 的 回 滚 。 
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升级 完成 
aA D 
wo 容器 me Be a 
APl 查 看 
状态 S SiR $ IP 地 址 © N o 镜像 人 统计 克隆 
springcloud-provider-1 元 serverA 172.17.238.239/sprin... > : 
springcloud-provider-1 “元 serverA 172.17.238.239/sprin... 
a N 
springcloud-provider-2. 7 ServerB 172.17.238.239/sprin.. n/a | 
springcloud-provider-2 7 ServerB 172.17.238.239/sprin... m 


图 20-41 服务 升级 后 选项 


在 此 页 面 的 右上 角 可 以 选择 升级 完成 或 者 回 滚 ， 如 果 选 择 升级 完成 ，Rancher 会 删除 旧 的 
容器 ;如 果 选 择 回 滚 ，Rancher 会 关 掉 新 容器 ， 启 动 旧 容 器 。 
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第 五 篇 工 具 篇 


前 面 四 篇 已 经 把 Java 服务 端 研 发 所 用 到 的 语言 、 框 架 、 组 件 和 部 署 等 内 容 都 讲述 完了 ， 
之 所 以 在 最 后 编写 此 篇 内 容 ， 是 由 于 其 很 难 归 入 以 上 四 类 ， 并 且 这 些 工具 的 使 用 对 一 名 研发 人 
员 来 讲 非常 重要 。 

本 篇 仅 有 一 章 内 容 ， 介 绍 了 日 常 使 用 的 工具 ， 这 些 工具 的 选择 也 是 作者 从 研发 技术 角度 进 
行 考虑 的 。 编 写本 篇 之 初 选择 的 内 容 很 多 ， 包 含 bug 管理 工具 、 进 度 管理 工具 等 ， 但 是 最 后 作 
者 确定 内 容 时 ， 觉 得 这 类 工具 应 该 属于 项 目 管理 的 范畴 ， 所 以 没有 选 录 进 来 。 当 然 工具 还 不 止 
这 些 ， 还 包含 二 维 码 生 成 工具 、 音 视频 转换 工具 等 等 ， 但 是 作者 认为 这 类 工具 更 偏向 于 某 一 技 
术 ， 而 不 够 通用 ， 所 以 也 没有 选 录 进 来 ， 最 后 选择 的 内 容 就 是 目前 读者 看 到 的 这 些 。 

本 篇 介绍 的 工具 有 : Swagger 用 于 生成 接口 文档 并 且 验 证 接口 和 调试 ，Jmeter 用 于 模拟 真 
实 的 请 求 和 压力 ; ab 用 于 验证 服务 本 身 的 性 能 ; VisualVM 用 于 查看 服务 的 运行 情况 ; JD-GUI 
用 于 反 编 译 程 序 ， 查 看 程序 包 的 代码 情况 。 

希望 通过 本 篇 的 学 习 ， 读 者 能 够 在 工作 中 及 时 检验 服务 的 状态 ， 提 高 自己 的 编码 质量 。 


21m 第 用 工具 


本 章 将 介绍 Swagger、JMeter、ab、VisualVM、JD-GUI 工具 的 使 用 ， 这 些 工具 会 帮助 你 
提高 工作 效率 和 质量 。 


21.1 Swagger 


在 之 前 编写 的 工程 ! 


，Controller 类 中 实现 的 方法 都 是 为 前 台 服 务 提供 的 能 力 接口 ， 前 台 


研发 需要 知道 后 端 提供 了 什么 样 的 接口 ， 包 含 接口 路 径 、 采 取 什 么 调用 方式 、 传 递 什么 参数 等 


信息 ， 这 样 前 SFE Wh 


但 是 这 种 方式 存在 流程 
那么 除了 


E 正 确 调 用 后 端 接口 。 


传统 的 做 法 是 后 全 研发 人 员 先 设计 接口 ， 然 后 形成 接口 文档 ， 继 而 进行 后 合 业 务 的 研发 ， 


上 的 和 人 为 的 几 个 问题 。 在 后 台 研 发 过 程 中 ， 发 现 某 一 接口 需要 改动 ， 


区 改 代 码 以 外 还 需要 修改 接口 文档 并 且 通 知 前 端 信 员 ; 接口 文档 由 于 人 为 的 原因 编写 


错误 或 者 滞后 ， 或 者 接口 不 可 用 而 无 法 及 时 验证 ;最 主要 的 是 对 于 研发 人 员 来 讲 ， 相 对 于 编写 


文档 ， 大 家 都 更 喜欢 写 代 码 ， 频 老 的 修改 文档 会 大 大 降低 效率 ， 而 Swagger 可 以 减少 文档 工作 
对 研发 效率 的 影响 ? 。 
Swagger 是 一 个 接口 文档 的 自动 生成 及 测试 软件 ， 它 的 优点 和 缺点 一 样 明 显 ， 或 者 说 


S 


H 


Web 页 面 ， 页 面 9 


S 


I AAS 


wagger 的 缺点 正 是 它 


优点 的 所 在 。Swagger 是 一 个 强 侵入 的 接口 文档 生成 工具 ， 需 要 在 代码 


编写 接口 的 说明 性 注解 ， 而 这 可 能 正 符合 某 些 研发 人 员 不 想 专 门 写 文档 的 心态 。 在 代码 中 写 
一 些 注解 就 能 形成 文档 ， 很 多 人 还 是 能 够 接受 的 。Swagger 可 以 根据 这 些 注 解 自 动 生 成 一 个 


包含 研发 者 编写 的 接口 说 明 ， 并 且 可 以 直接 调用 接口 进行 测试 。 下 面 在 


pring Boot 工程 中 演示 Swagger 的 主要 用 法 。 


21.1.1 Swagger 基本 配置 


ZN 


1) 添加 依赖 


<dependency> 


使 用 之 前 编写 的 SpringBootMybatis 工程 ， 在 工程 中 进行 如 下 改造 ， 引 入 Swagger。 


在 pom 文件 中 ， 添 加 如 下 依赖 ; 


<groupId>io.Springfox</groupId> 
<artifactId>springfox-swagger2</artifactId> 
<version>2.6.1</version> 


</dependency> 
<dependency> 


<groupId>io.Springfox</groupId> 
<artifactId>springfox-swagger-ui</artifactId> 
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<version>2.6.1</version> 
</dependency> 


(2) 添加 Swagger 配置 
新 建 一 个 类 SwaggerConfig， 在 此 类 中 添加 如 下 代码 : 


@Configuration 
public class SwaggerConfig { 
@Bean 
public Docket createRestApi() { 
return new Docket(DocumentationType.SWAGGER 2) 
.apilnfo(apilnfo()).select() 
.apis(RequestHandlerSelectors.basePackage("com.javadevmap.mybatis.controllers")) 
.paths(PathSelectors.any()) 
-buildQ; 


} 


private Apilnfo apilnfo() { 
return new ApilnfoBuilder() 
.title("Spring Boot Mybatis 接口 文档 ") 
.description("Spring Boot Mybatis Swagger2 UserService Interface") 
.termsOfServiceUrl("127.0.0.1:18089") 
.version("0.0.1") 
-buildQ; 


} 


(3) 开启 Swagger 
在 启动 类 中 添加 注解 @EnableSwagger2。 经 过 这 几 步 ， 就 完成 了 Swagger 的 基本 配置 ， 下 
面 就 可 以 对 每 一 个 Controller 实现 接口 文档 的 编写 。 


21.1.2 ”使 用 Swagger 编写 接口 文档 


在 此 工程 的 UserController 类 中 ， 对 类 和 方法 添加 注解 ， 就 可 以 形成 一 个 带 测 试 能 力 的 接 
文档 。 
@Api(value=" 用 户 服务 ") 
@RestController 
@RequestMapping("/user") 
public class UserController { 
@ApiOperation(value=" 获 取 用 户 信息 ", notes=" 根 据 id 获取 用 户 信 息 ") 
@ApilmplicitParam(name = "Id", value = "用 户 Id", 
required = true, dataType = "integer", paramType = "path") 
@RequestMapping(value="/{Id}",method=RequestMethod.GET) 
public Result<DomainUser> getUser(@PathVariable("Id") int id) { 


} 


@ApiOperation(value=" 添 加 用 户 ", notes=" 获 取 用 户 信 息 并 保存 ") 
@ApilmplicitParams({ 

@ApilmplicitParam(name = "user", value = "H PR IA", 
required = true, dataType = "DomainUser" paramType = "body") 


= 


3) 
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@RequestMapping(value="/add",method=RequestMethod.POST) 
public Result<String> addUser(@RequestBody @ Valid DomainUser user) { 


} 


@Apilgnore() 


@RequestMapping(value="/ignore",method=RequestMethod.GET) 
public Result<String> ignore() { 


} 
} 


在 上 面 的 代码 中 ， 新 添加 了 一 些 注解 ， 有 些 注解 添加 在 类 上 ， 有 些 注解 添加 在 方法 上 ， 有 
些 注解 能 够 一 眼看 出 它 是 在 说 明 方 法 参数 。Swagger 就 是 通过 这 种 污 


继而 生成 文档 的 。Swagger 常用 的 注解 及 作用 见 表 21-1. 


表 21-1 Swagger 注解 


FE 解 的 形式 对 接口 进行 说 明 


$X f 作 
@Api 作用 于 类 ， 说 明 接 口 类 
@ApiOperation 作用 于 方法 ， 提 供 接口 说 明 
@Apilgnore 作用 于 类 、 方 法 、 参 数 ， 目 的 是 忽略 被 标注 内 容 
@ApilmplicitParam 作用 于 方法 ， 表 示 单 个 请 求 参 数 
@ApilmplicitParams 作用 于 方法 ， 表 示 多 个 请 求 参 数 
@ApiParam 作用 于 方法 、 参 数 、 字 段 ， 描 述 参 数 
@ApiModel 作用 于 类 ， 说 明 对 象 实体 类 
@ApiModelProperty 作用 于 方法 、 字 段 ， 描 述 对 象 的 方法 、 字 段 
@ApiResponses 作用 于 类 、 方 法 ， 响 应 描述 集 
@ApiResponse 作用 于 方法 ， 响 应 描述 


21.1.3 Swagger 测试 演示 


完成 对 Controller 类 的 配置 后 ， 启 
后 加 上 /swagger-ui.html 路 径 ， 例 如 http://localhost:18089/swagger-ui.html， 就 可 以 看 到 Swagger 
的 可 视 化 界面 ， 如 图 21-1 所 示 。 


@ 


Spring Boot Mybatis 接 口 文档 


动 此 服务 ， 然 后 通过 浏览 器 访问 此 服务 的 地 址 ， 在 地 址 


Spring Boot Mybatis Swagger2 UserService Interface 


user-controller 


Ea /user/add 


foam /user/{Id} 


(1) GET 方法 测试 


图 21-1 


Swagger 可 视 化 页 面 


default (/v2/api-docs) ¥ 


点 击 页 面 中 的 /user/{1d} 方 法 ， 可 以 看 到 接口 说 明 ， 并 且 包 含 了 返回 


404 


类 型 的 模板 、 参 数 的 输入 


> 


类 型 


aS 


/user/{1d} 


Implementation Notes 
根据 id 获取 用 户 信息 


Response Class (Status 200) 
OK 


Example Value 


m: “string”, 


"string", 


“phoneNum": "string" 


": "string", 
"resultCode": @ 


Response Content Type | */* ¥ 


Parameters 
Parameter Value 
Id 7 


Response Messages 


HTTP Status Code Reason 

401 Unauthorized 
403 Forbidden 
404 Not Found 
Try it out! 


RR 


(2) POST 方法 测试 


tesa /user/add 


Implementation Notes 
获取 用 户 信息 并 保存 


Response Class (Status 200) 
OK 


Example Value 


Response Content Type | */* ¥ 
Parameters 


Parameter Value 


user 


age”: 
“name”: ”javadevmap”, 
“phonelun”: ” 12345678901" 


} 


EE 等 。 可 以 在 输入 框 中 填写 数据 ， 然 后 点 击 “Try it out!” 就 能 实现 接 


Description 


用 户 Id 


Response Model 
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获取 用 户 信息 


Parameter Type Data Type 


path undefined 


Headers 


21-2 获取 用 


击 页 面 中 的 /user/add 方法 ， 同 样 可 以 看 到 相关 的 接 
型 ， 在 页 面 中 “添加 参数 ”的 右 侧 还 列 出 了 提交 数据 的 模板 ， 如 


Description 


用 户 信息 


Parameter content type: | application/json Y 


Reason 
201 Created 
401 Unauthorized 
403 Forbidden 
404 Not Found 


Try it out! 


Response Model 


户 信 息 接 


常用 工具 


测试 ， 如 图 21-2 所 示 。 


说 明 等 。 由 于 提交 的 是 
图 21-3 所 示 。 


用 户 


Parameter 
= 
Type Data Type 


body Example Value 


"address": "string", 


"name 


"phoneNum" 


} 


Headers 


添加 用 


pas 


个 自 定 义 
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21.2 JMeter 


Apache JMeter? 是 一 款 优秀 的 ] 


开源 性 能 测试 工具 。 用 于 测试 静态 和 动态 资源 ， 


模拟 用 户 访问 场景 ， 监 控 系 统 资源 的 变化 从 而 得 到 程序 的 性 能 。 另 外 ，JMeter 能 够 对 应 用 程序 


做 功能 /回归 测试 ， 通 过 创建 带 有 断言 的 脚本 来 验证 程序 是 否 返回 了 期 望 的 结果 。 


21.2.1 JMeter 的 环境 搭建 


登录 http://jmeter.apache.org/download jmeter.cgi， 根 据 自 己 的 操作 系统 ， 下 载 对 应 版 本 的 
文件 ， 然 后 解压 到 本 地 即 可 。 本 书 编写 时 ， 最 新 版 本 为 4.0 版 本 ， 本 节 以 此 版 本 进行 讲解 。 
JMeter 的 目录 结构 见 表 21-2。 


表 21-2 JMeter 的 目录 结构 


录 作 
bin 可 执行 文件 目录 
docs Jmeter 帮助 文档 
extras 提供 了 对 Ant 的 支持 文件 ， 也 可 用 于 持续 集成 
lib Jmeter 依赖 的 jar 包 ， 同 时 安装 的 插件 也 放 于 此 
licenses 软件 许可 文件 


Í Apache JMeter (4.0 r1823414) 


File Edit Search Run Options Help 


软件 默认 语言 为 英文 ， 可 以 通过 “Options->Choose Language->Chinese(Simplified)” w H 


成 中 文 。 


HO@@ad Xoo +=: 


Test Plan 
Name: Test Plan 


Comments: 


ROO ww me E 


Name: 


Add | | Add from Clipboard 


E 


User Defined Variables 


(J Run Thread Groups consecutively (i.e. one at a time) 


i jmeter.bat 即 可 看 到 JMeter 可 视 化 页 面 ， 


加 Run tearDown Thread Groups after shutdown of main threads 


(J Functional Test Mode (i.e. save Response Data and Sampler Data) 


如 图 


21-4 所 示 。 


poouo Ao 


Value 


o x 
oo 的 


Selecting Functional Test Mode may adversely affect performance. 


Add directory or jarto classpath | Browse... Delete Clear 


Library 


图 21-4 JMeter 可 视 化 页 面 


© Jmeter 的 官网 是 http://jmeter.apache.org/index.html。 
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21.2.2 ”测试 计划 


一 个 完整 的 测试 计划 包括 一 个 或 多 个 元 素 ， 例 如 线程 组 、 逻 辑 控制 器 、 样 品 产 生 控制 器 、 
监听 器 、 定 时 器 、 断 言 和 配置 等 。 

本 节 使 用 之 前 章节 编写 的 获取 用 户 信 息 接 口 的 代码 ， 演 示 接 口 测试 功能 。 

(1) 新 建 线 程 组 (Thread Group) 
在 JMeter 软件 的 测试 计划 (Test Plan) 上 ， 执 行 “鼠标 右键 单 击 ->add->Threads (Users) 
->Thread Group”。 如 图 21-5 所 示 。 


£ Apache JMeter (4.0 r1823414) 一 口 x 
File Edit Search Run Options Help 
i@ad SOO t+-* PROG ww at FE poooo 人 om QO 
A Test Fimis 
Add 


> Threads (Users) > Thread Group 


Paste HA Config Element > | setUp Thread Group 
Open. Listener > | tearDown Thread Group [~ ”| 
merge Timer > 
Save Selection As. 
Pre Processors > User Defined Variables 
Save Node As Image Ctrl+G Post Processors > - 
Save Screen As Image Ctri+Shift+G Name. a 
Assertions > 
Test Fragment > 
Disable Non-TestElements > 
Toggle Ctrl+T 
Detail Add Addfrom Clipboard Delete D 
Help 


|] Run Thread Groups consecutively (i.e. one at a time) 
v Run tearDown Thread Groups after shutdown of main threads 


|_] Functional Test Mode (i.e. save Response Data and Sampler Data) 


Selecting Functional Test Mode may adversely affect performance. 


Add directory or jar to classpath | Browse... Delete Clear 


Library 


图 21-5 ”新建 线程 组 


在 新 建 的 Thread Group 页 面 的 Thread Properites 面板 中 ， 保 持 默认 选项 即 可 ， 即 启动 一 个 
线程 发 起 一 次 请 求 。Thread Properites 中 选项 的 含义 如 下 : 
E Number of Threads (Users): 模拟 的 并 发 线程 数 。 
E Ramp Up Period (in seconds): 在 多 长 时 间 内 启动 所 有 的 线程 。 例 如 Number of Threads 
设 为 10，Ramp Up Period 设 为 1， 则 Jmeter 每 隔 0.1s 启动 1 个 线程 。 
E Loop Count: 单 用 户 任 务 重复 执行 的 次 数 。 如 果 设 为 Forever， 那 么 Jmeter 就 不 会 自动 
停止 ， 需 要 强制 终止 。 
(2) 添加 采样 器 (Sampler ) 
在 新 建 的 线程 组 节点 上 ， 执 行 “鼠标 右键 单 击 ->Add->Sampler->HTTP Request” 选 项 ， 
添加 HTTP 请 求 采 样 。 压 力 测试 获取 的 用 户 信息 接口 是 http://47.95.113.117:18010/ user/7， 如 
21-6 所 示 。 
在 右边 输入 页 面 的 Web Server 页 签 中 ， 填 写 请 求 相 关 信息 ， 即 请 求 url 和 参数 。 
(3) 添加 监听 器 〈Listener) 
添加 一 个 监听 器 ， 相 当 于 程序 的 console 控制 台 ， 可 以 直接 查看 结果 。 在 HTTP Request 上 
es “鼠标 右键 单 击 ->Add->Listener->View Results Tree”， 添 加 监听 线程 组 〈 用 户 )。 如 
4] 21-7 所 示 。 
设置 完成 后 ， 在 菜单 栏 上 点 击 “Run->Start” 执 行 用 例 ， 会 弹出 对 记 


= 


H 


6 框 让 你 先 保存 用 例 ， 
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然后 再 进行 测试 。 


f Apache JMeter (4.0 r1823414) 
File Edit Search Run Options Help 
Hé@ad XDA t-*+ PPOO ww art EE Foooo Ao om >) 
á Test Plan 
v <@} Thread Group HTTP Request 
pA HTTP Reauest | 


Name: HTTP Request 


Comments: 


EC 


Web Server 


Protocol [http]: http Server Name or IP: 47.95.113.117 PortNumber: 18010 


Method: GET w| Path: /user/7 Content encoding: 


Co Redirect Automatically [W] Follow Redirects [V] Use KeepAlive [| Use multipartiform-dats for POST 四 Browser-compatible headers 


Í Parameters | Body Data | Files Upload 


Send Parameters With the Request: 


i Name © Value Encode? Include Equals? 


Detail Add Add from Clipboard Delete Up Down 


图 21-6 添加 采样 器 


# HTTP Requestjmx (C:\apache-jmeter-4.0\bin\HTTP Requestjmx) - Apache JMeter (4.0 r1823414) 一 口 x 
Eile Edit Search Run Options Help 


D@Gad XOO +=-*+ PROS ww etd HB poo Ao on © 


Y æ TestPlan J a 
v @} Thread Group View Results Tree 
A | 
g HTP Request Name: View Results Tree 
Pg ViewResuts Te | 
| Comments: 
| = 
Write results to file / Read from file 
r 
Filename Browse... | Log/Display Only: [| Errors {_] Successes | Configure 
| Search: [U] case sensitive [| Regular exp. | Search Reset 
| a> = 
| | Text v I Sampler result | Request | Response data | 
= = 
>|) CresultCode™:200,"msg".ok","data™.fid".7,"address" 地 球 ",“age":18,"name".*svn","phoneN 
um"."123456789017}} 
| MA 


图 21-7 添加 监听 器 

测试 完成 后 ， 可 以 看 到 请 求 的 响应 数据 。 当 然 在 实际 测试 中 ， 要 根据 业务 需要 来 设置 对 应 
的 线程 数 以 及 并 发 测试 数 。 这 里 演示 的 是 最 基本 的 JMeter 使 用 ， 如 果 想 了 解 更 多 功能 ， 可 以 
登录 JMeter 的 官网 进行 学 习 。 


21.3 ab 


ab 是 Apache 提供 的 一 球 压 力 测试 工具 ， 用 来 测试 服务 器 负载 压力 。 为 了 保证 测试 准确 
FE, ab 需 与 目标 服务 器 处 于 同一 内 网 中 进行 测试 。 非 内 网 环境 对 Web 服务 器 进行 压力 测试 ， 
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会 由 于 网 络 延 时 过 大 或 带宽 不 足 ， 造 成 测试 效果 不 准确 。 
KRE Linux 服务 器 上 进行 测试 。Linux 服务 器 的 版 本 为 CentOS 7.3。 通 过 客户 端 登 
录 到 服务 器 上 后 ， 执 行 如 下 命令 安装 ab: 
$ yum -y install httpd-tools 
执行 如 下 命令 ， 碍 看 ab 版 本 来 检测 是 否 安装 成 功 。 
$ ab -V 


21.3.1 压力 配置 
测试 之 前 编写 的 获取 用 户 信 息 接口 程序 ， 模 拟 50 个 并 发 用 户 ， 对 此 接口 发 送 1000 个 请 求 。 
$ ab -n1000 -c50 http://127.0.0.1:18010/user/7 
LME H-n 表示 总 请 求 数 ，-c 表示 并 发 数 。 当 然 ab 的 常用 命令 远 不 止 这 些 ， 见 表 21-3. 


表 21-3 ab 工具 常用 命令 


参数 a Ce 
-n 请 求 的 总 数 ， 默 认为 1 次 
-c 并 发 数 ， 同 一 时 间 请 求 数量 
-p° POST 请 求 ， 文 件 中 包含 请 求 数据 ， 根 据 数据 格式 ， 设 置 -T 参数 
-T 针对 POST/PUT， 设 置 请 求 头 中 的 Content-type， 例 如 : application/json。 默 认 是 text/plain 
-w 将 测试 结果 打印 到 HTML 表格 中 


21.3.2 ”结果 查看 
在 执行 ab 测试 命令 之 前 ， 先 了 解 一 下 ab 返回 参数 的 含义 ， 见 表 21-4。 


表 21-4 ab 测试 返回 参数 含义 


参 数 名 we X 
Concurrency Level 并 发 数 ， 等 于 -c 后 面 的 数值 
Time taken for tests 测试 总 耗 时 
Complete requests 成 功 收 到 返回 的 数 
Failed requests 请 求 失败 数 
Requests per second 每 秒 请 求 数 ， 等 于 总 请 求 数 /测试 总 耗 时 
每 一 个 请 求 平均 花费 时 间 : 
Ti i 第 一 个 Time per request 为 用 户 平 均 请 求 等 待 时 间 ; 
ENG Seater 第 二 个 Time per request 为 服务 器 平均 处 理 时 间 ; 
户 平 均 请 求 等 待 时 间 = 服务 器 平均 处 理 时 间 x 并 发 数 


执行 ab 命令 ， 得 到 如 下 输出 结果 ; 
$ ab -n1000 -c50 http://127.0.0.1:18010/user/7 
..….// 省 略 


© 例如 ab -n 1 -c 1 -p 'post.txt' -T 'application/json' 'http://localhost:18010/user/add' 命 令 用 于 测试 POST 请 求 。post.txt 为 上 传 的 
Json 数据 内 容 的 文件 。 
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Server Software: 
Server Hostname: 
Server Port: 


Document Path: 
Document Length: 


Concurrency Level: 
Time taken for tests: 
Complete requests: 
Failed requests: 
Write errors: 

Total transferred: 
HTML transferred: 


Requests per second: 


Time per request: 
Time per request: 
Transfer rate: 


127.0.0.1 
18010 


/user/7 
111 bytes 


50 
1.529 seconds 
1000 
0 
0 
289000 bytes 
111000 bytes 
653.99 [#/sec] (mean) 
76.454 [ms] (mean) 
1.529 [ms] (mean, across all concurrent requests) 
184.57 [Kbytes/sec] received 


Connection Times (ms) 


min mean[+/-sd] median max 
Connect: 0 255} 0 24 
Processing: 674372 65 305 
Waiting: 3 IB SM 65 305 
Total: 6 75 369 66 305 
..// 省 略 


从 上 面 的 输出 结果 可 见 ， 本 次 测试 总 耗 时 (Time taken for test) 1.3529s; 请 求全 部 完成 
(Complete requests) 共 1000 ^, KRW (Failed requests) 个 数 为 0 个 ;每 秒 平均 请 求 数 
(Requests per second) 为 653.99 个 ; 用 户 平均 请 求 (Time per request) 等 待 时 间 为 76.454ms, 


服务 器 平均 请 求 处 理 时 间 为 1.529ms。 


21.4 VisualVM 


VisualVM 可 以 对 Java 程序 进行 运行 时 监控 ， 
的 CPU、 内 存 、 类 、 线 程 等 ， 还 可 以 添加 插件 对 程序 的 
同时 安装 ， 所 在 路 径 为 %JAVA_HOME%\bin\jvisualvm.exe。 本 节 演 示 此 工具 的 基本 用 法 。 


21.4.1 查看 CPU 
使 用 之 前 编写 的 SpringBootMybatis 工程 ， 


此 工具 提供 了 图 形 界 面 ， 可 以 监控 程序 使 用 
他 信息 进行 监控 。VisualVM Ë JDK 


在 工程 中 添加 一 个 简单 的 Java 类 JvmCpuTest, 


此 类 仅 作 为 测试 VisualVM 工具 对 CPU 的 监控 ， 不 作为 业务 逻辑 。 


(1) 单个 线程 的 CPU 使 用 


public class JvmCpuTest { 
private static void singleThread() { 


try { 
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在 此 类 中 添加 如 下 代码 ， 然 后 执行 此 main 方法 。 
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long time = 1; 
while(time>0) { 
time = System.currentTimeMillis(); 


} 
} catch (Exception e) { 
e.printStackTrace(); 


j 
} 


public static void main(String[| args) { 
singleThread(); 
} 
} 


在 以 上 代码 中 编写 了 一 个 无 限 循环 。 执行 此 main 方法 后 ， 进 入 VisualVM 工具 ， 可 以 在 
页 面 的 左 侧 看 到 此 Java 服务 进程 ， 双 击 此 进程 可 以 看 到 它 的 监控 页 面 ， 选 择 监控 页 面 的 标签 
可 以 进入 相应 的 监控 项 ， 这 里 选择 “监视 ”标签 ， 可 以 看 到 如 图 21-8 所 示 页 面 ，CPU 使 用 率 
大 约 为 23%〈 测 试 程序 所 运行 主机 CPU 为 4 核 )。 


Hon Mae Be Mae 
Fie oa Ë nmp 


fest (oid usu) | 正常 运行 时 间 : 3 分 4 和 
CPU 使 用 情况 : 24 1% 拉 志 回收 活动 : 0 o 已 使 用 = 32. 038. 536 个 字 节 
Bor RARR EHRE Bi k 国信 有 的 e 
I x | 线程 x 
BRAMMER: 1 540 共享 的 已 装 入 刍 : 0 活动 : 10 寺 护 进程 : 9 
cama: 0 AOE: 0 SOIR 10 ab: 10 


BERANAMA mI ASM att 目 实时 线程 Elite 


图 21-8 服务 监控 页 面 


(2) 多 线程 CPU 使 用 
修改 以 上 测试 代码 ， 让 两 个 线程 同时 执行 此 无 限 循 环 ， 观 察 CPU 的 使 用 情况 。 


public class JvmCpuTest { 
private static void multiThread() { 
ExecutorService eService = Executors.newFixedThreadPool(2); 
for(int i=0;1<2;1++) { 
eService.execute(new Runnable() { 
@Override 
public void run() { 
try { 


long time = 1; 
while(time>0) { 
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time = System.currentTimeMillis(); 


} 
} catch (Exception e) { 
e.printStackTrace(); 


} 
由 


eService.shutdown(); 


} 


public static void main(String[| args) { 
multiThread(); 
j 
} 


这 里 使 用 两 个 线程 执行 无 限 循环 ， 运 行程 序 后 ， 可 以 看 到 CPU 使 用 情况 如 图 21-9 所 示 ， 
CPU 使 用 率 大 概 为 50% 左 右 。 在 界面 上 方 的 标签 中 ， 还 可 以 选择 “抽样 器 ”查看 CPU 的 具体 


使 用 情况 。 


图 21-9 使 用 两 个 线程 后 的 服务 监控 页 四 


21.4.2 ”查看 线程 


的 说 明 ， 在 页 面 中 可 以 看 到 名 为 http_nio-18089-exec* 的 线程 共 10 个 。 


en Ftpatest (pid 0856) =| 
Ler Greene 加 Joeale Plugins Eris of [E] Tracer 
ybatis. jvisualvm. JvmCpuTest (pid 6656) 
on One Ba ase 
ERZA: o #12 timm | E toe 
cw 
ru 合用 情况 : 35.69 SIRENS: 0.08 已 合用: 15,600,966 十字 
Dore HABA 目 坟 如 加 和 动 Bi 大 小 旧居 的 夫 
x x BE x 
BAME L62 REMERA: 0 活动: 12 F o 
BHRMHA: 0 ASHER: 0 SUSE 12 已 让 的 总 数 : 二 
BERAMAN B HENERNA CEE 


在 本 机 启动 SpringBootMybatis 工程 ， 然 后 在 VisualVM 工具 中 进入 此 工程 监控 中 的 “ 线 
程 ” 标 签 ， 可 以 看 到 如 图 21-10 所 示 的 页 面 情况 ， 页 面 的 右 下 方 包含 了 对 此 进程 中 各 线程 状态 


停止 此 程序 ， 然 后 在 ym 文件 中 添加 如 下 配置 ， 启 动工 程 后 ， 可 以 在 VisualVM 了 
“线程 ”标签 下 看 到 名 为 http-nio-18089-exec* 的 线程 共 30 个 ， 如 图 21-11 所 示 。 


server: 
port: 18089 
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tomcat: 
min-spare-threads: 30 


[E Jova Visum -o x 
RHO HRABRA UEV TRO EOW eu) 
GS Shas 
mex || i x |B een jeden nyhotic Springheaghetisgplication (pid 23058) 六 | 24 
(Be Bday DA AMAR Orfila 多 pees E console Hugins = visual © E] Truer 
ipae (pid 5720) © com. javadevmap. mybatis. SpringBootMybatisApplication (pid 28956) 
t apasha. justar. lerDrsver (pd 19792) [3e amet 
FN: 29 HR omr 
e SPAR: 2 
Brenn pa z 
E a7. 83.199.101 ——— 
TAW ts dap Q Q Q | am: PERE 
RR a 15:25:10, 15:25:15 15:25:20 ^ saa 15:25:30 1:25:38 zaz at - 
日 mn Tep i, Ss 25,006 ae 25, We we 
Om server connection tine ons 25.006 as 
Ham Scheider (0) _—SS SF Ons 25,006 me 
MM TP Cemmostiea(l)-127.( one 35,006 we 
日 nestrozrevent Se ee 25.006 as 23.006 ms 
Bg pa 592 EE ons 25,006 as 
ee | 25,006 nz 25,006 we 
一 一 26,008 me (008) 25,006 me 
Die int ET 25.000 ns (100) 25,006 ms 
Ee Nl | Oas 00 ms 
= one 35,006 we 
—— One 25,006 me 
站 一 ons 25.006 as 
ee ES On 25,006 a= 
ee ed one 35,006 we 
i ons 23.006 ms 
ee ed ons 25.006 as 
eee ed One 35,006 we 
Ce ee n rnrn] Ons 25,006 me 
日 Homloctineseltetr 1 25.000 ns Gov 2.000 ns 
pe a TT On 25,006 w= 
Dating EE Bee 35,006 we 
日 ma Tce Accepto TEE 25.006 ns 2.006 ms 
I CP accep ee 25,000 as 25,006 as 
日 am TP hecept-0 _———— 25,006 ae 25,006 ae 
toch Listener = ss 25,006 me 5, 006 me 
H sical Dispetcher O el 25.005 as 25.006 ms 
日 riaaliaer ons 25,006 as 
B Reference Handle One 25,006 we 
P 3) Ber Bar OF8 Be Ban 
图 21-10 ”线程 监控 
S a fa w 
图 Jam veuavw - a x 
文件 (日 应 用 程序 (入 视图) IRO Bow EIH) 
| 
RABE Xx | = || atam x] & con. jevadewnap. nybatis SrringSootttybati sApplicetion (yid 21024) x] EE 
Ta p (Bed Man ESE RME Orfila Bies Bytom Plugins E] visal © [E] tracer 
H vinim 
È teipe Gia 5720) © com, javadevmap. mybatis. SpringBootMybatisApplication (pid 21024) 
ore apache jeter Hengriver (pid 19792) | ae Bgam 
dip Gil 
S FME: 如 SE Damp 
oam FPE 
TB asoa = = 
$ 92.190.101 
Baw Bet am a A A | am: [ARE 
See a 15:38:25 15:31:30 15:33:35 15:09:40 15:33:45 15:38:30 15:33:55 运行 
Dea A EN :or5 a (00) 140,075 =- 
TT ET 140,075 ac (08) 140,075 me 
二 二 一 一 一 
25-0 Das (08) 140,075 ms 
ep 1 a Das ow) 140,075 we 
Bieri ons (09) 140,079 ms 
EEE Dms (09) 140,075 ns 
De een — One (08 10,075 
et DOme 140.075 me 
See Dns co 140,075 as 
PP aaa Das (09) 140,075 ms 
"E G Das (oa 140,075 me 
一 一 ons (9) 140,079 ns 
el Da (0D) 140,075 me 
a a] Das (0 140,075 me 
Bie ons (08) 140,079 ns 
Mbopo OOOO eneee Das (08) 140,075 ms 
ee ED Das (D| 140,075 me 
5195 Das (ov 
Beep e085 a Das (08 
p18 One (08 
ip 1 Ome (08) 140,075 me 
一 ons (9) 140,079 ns 
a a] Deo) 140,075 
htt ni e10080-ereeg Dae (0| 140,075 me 
ttni e009-eree-s ons (0) 140,079 ns 
htt ei-10089-eree-T Das (| 140,075 as 
htt ni e10080-eroe-6 Dar (0D) 140,076 me 
Bitti e009-exee-5 ons (9) 140.078 ms 
ht ni 10009 -exect Dms (08) 100,079 ns 
tt si e10080-eree-? Das (0| 140,075 me 
tyrni e18089-exee-2 Das (08) 140.015 ms 
rp mie-10009 -exec 1 Dms (0| 140,075 ns 
enlochingel eetor Becke! 10,075 G09 0,078 me 
j ey mak Ose oe men 


图 21-11 修改 配置 后 的 线程 监控 


21.4.3 ”监控 远程 服务 


VisualVM 工具 除了 对 本 地 的 Java 服务 进行 监控 ， 还 可 以 监控 远程 服务 器 上 的 Java 服务 运 
行 状态 。 这 里 简单 介绍 监控 远程 服务 的 方法 。 

(1) 启动 远程 服务 
在 远程 服务 器 中 ， 使 用 如 下 命令 启动 服务 ， 此 命令 包含 了 远 


SH 


旦 连接 的 相关 配置 。 


413 


Java 服务 端 研 发 知识 图 谱 


$ nohup java —Djava.rmi.server.hostname=47.93.199.101 -Dcom.sun.management.jmxremote -Dcom. sun. 
management.jmxremote.port=18088 —Dcom.sun.management.jmxremote.rmi.port=18088 —Dcom.sun. 


management. jmxremote.authenticate=false -Dcom.sun.management.jmxremote.ssl=false -jar -Xmx128m Spring 
BootMybatis—0.0.1-SNAPSHOT jar & 


(2) 在 工具 中 配置 连接 

在 VisualVM 工具 中 ， 选 择 “ 远 程 -> 添加 远程 主机 ” 在 输入 框 中 添加 远程 服务 器 地 址 ， 

如 图 21-12 所 示 ， 然 后 点 击 确定 ， 这 样 就 添加 了 远程 服务 器 。 
添加 完 远程 服务 器 后 ， 鼠 标 右 键 单 击 此 服务 器 ， 然 后 选择 “添加 JMX 连接 ” 在 弹出 的 输 

入 框 中 输入 连接 地 址 ， 如 图 21-13 所 示 。 


[7] 添加 JMX 连接 X 


连接 (C): 47. 93. 199. 101:18088 
用 法 : 《主机 名: 端口》 或 service: jax: (HUO: <sap> 


1 47.93. 199. 101:18088 


使 用 安全 任 证 (E) 
人 APRU: 
二 4 


口令 (了 ): 


主机 名 (H): 147.93. 199. 101 


显示 名 称 (D): |47.93. 199. 101 


保存 安全 任 证 (8 


FERSEN) 


高 级 设置 (4) 取消 取消 
图 21-12 ”配置 远程 主机 连接 图 21-13 添加 JMX 连接 
完成 如 上 设置 后 ， 就 可 以 看 到 要 监控 的 远程 程序 了 ， 如 图 21-14 所 示 。 
oe JAV IAD EOW HIH nas 
GS Baht 
nner] = sal 
Hi Hy s visoal oc E trs 
© 47. 93. 199. 101: 18088 (pid 19735) 
we Mo 回 内存 Ba Dee 
CPU SAAR: 0.5% 过 起 回收 活动 : 0. cm 已 使 用 : 41, 275, 720 个 字 节 
ee 
K l= 
az SAE 
BAMBA: 5, 053 共享 的 已 装 入 数 : 0 活动 : 47 寺 护 进程 : 5 
已 乔 载 的 兽 茹 : 0 ASME: 0 实时 峰值 : 47 已 启动 的 总 数 : 52 
Peer ret ”se meet 


图 21-14 远程 服务 监控 


21.5 JD-GUI 


JD-GUI 是 一 个 反 编译 工具 ， 它 可 以 把 已 经 生成 的 Jar 包 反 编译 回 代 码 的 形式 ， 没 有 经 过 
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代码 混淆 的 Jar 包 反 编译 后 和 实际 的 源码 会 有 一 定 的 差别 ， 但 是 
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“影响 阅读 。JD-GUI 是 可 视 


化 的 ， 所 以 使 用 起 来 非常 简单 ， 只 要 引入 Jar 包 就 可 以 执行 反 编 译 。 这 里 展示 SpringBoot 


Mybatis 工程 的 Jar 包 反 编译 后 的 效果 。 如 图 


21-15 所 示 。 该 工具 的 网 址 是 http://jd.benow.ca。 


{É UserController.class - Java Decompiler - a x 
File Edit Navigation Search Help _ 
slavies 
加 SpringBootMybatis-0. 0, 1-SNAPSHOT. jar 52 
S-E Bor-e T UserController. class 28 
J- classes Facts as Rie, 
E com. javadevmap. mybatis a 


fH config 
S- controllers 
EEN UsexController. class | 
由 -加 UserController 
B dao 
{8 domain 
出 jvisualem 
E model 
E result 
E service 
{ib SpringBootMybatisApplication. class 
mybatis 
E sqlmep 
[R UserMapper. xml 
[À generatorConfig xml 
[M mybatis-config. xml 
B application. yal 
因 logback-spring xml 
H- lib 
EÈ META-DIE 
EÈ org springfranevork. boot. loader 


THERE 


pi(" 用 户 服务 


e({"/user"}) 


public class UserController 


et 


private static final Logger log = LoggerFactory.getLogger(UserController.class); 


owired 


private UserService service; 


public Result<String> addUser(@Re 


et 


tion(value=" 获 取 用 户 信息 "，notes=" 根 据 id 获 取 用 户 信息 ") 

tParam(name="Id", value=" 用 户 Id", required=true, dataType="integer", paramType="path") 
(value={"/{Id}"}, method={org.spri 

‘DomainUser> getUser(@PathV 


"Id") int id) 


DomainUser user = this.service.getUser(id); 
Result<DomainUser> result = null; 


if (user != null) { 

result = new Result (ResultCode.Ok, user); 
} else { 

result = new Result (ResultCode.Not_Found); 
} 


return result; 


user"，value=" 用 户 信 | 


equestMap} value={"/add"}, metho 


stBody EValid DomainUser user) 


int ret = this.service.saveUser(user); 
Result<String> result = null; 
if (ret == 1) { 
result = new Result (ResultCode.OK); 
} else { 
result = new Result (ResultCode. ERROR); 


eframework.web.bind. annotation. RequestMethod.GET}) 


", required=true, dataType="DomainUser", paramType="body")}) 
org. springframework.web. bind. annotation.RequestMethod.POST}) 


A 21-15 Jar 包 反 编 i 
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